Type Definitions
This is a collection of common type definitions that are shared between objects.
Payment Provider Transaction Status Codes
Software (SW)
These statuses are related errors found during the validation processes before the transaction is sent to the ODFI. These include risk and validation errors.
Status Code | Description |
---|---|
SW010 | Established |
SW013 | Canceled |
SW020 | Authorization received |
SW021 | Authorization declined due to insufficient funds |
SW051 | Merchant error |
SW052 | Financial Institution error |
SW053 | Internal network error |
SW054 | Suspicious transaction activity |
SW055 | Negative data |
SW056 | Invalid account |
SW057 | Expired split token |
SW059 | Instant transaction rejected due to risk |
SW060 | Bank or network processor is down |
User Canceled
These statuses are related to when the user cancels the transaction process. Each time the user cancels a status based on the point of cancellation is defined. Therefore, errors during user interaction.
Status Code | Description |
---|---|
UC01 | User canceled the transaction at bank selection page |
UC02 | User canceled the transaction at login page |
UC03 | User canceled the transaction at invalid login page |
UC04 | User canceled the transaction at challenge question page |
UC05 | User canceled the transaction at invalid answers for challenge questions page. |
UC06 | User canceled the transaction at MFA page |
UC07 | User canceled the transaction at invalid MFA page |
UC08 | User canceled the transaction at account selection page |
UC09 | User canceled the transaction at error page |
UC10 | User canceled the transaction at partial account number page |
UC11 | User canceled the transaction at select account location page |
UC12 | User canceled the transaction because it does not have a bank on the list |
UC13 | User canceled the transaction at login with captcha page |
UC14 | User canceled the transaction at captcha validation page |
UC15 | User canceled the transaction at manual account input page |
UC16 | User canceled the transaction at manual account confirmation page |
UC17 | User canceled the transaction at MCD confirmation page |
UC18 | User canceled the transaction at MCD validation page |
UC19 | User canceled the transaction at account profile input page |
UC20 | User canceled the transaction at no dynamic balance page |
UC21 | User canceled the transaction at partial account not supported page |
UC22 | User canceled the transaction at security script page |
UC23 | User canceled the transaction at account not supported page |
UC24 | User canceled the transaction at authorize page with exception |
UC25 | User canceled the transaction at bad account page |
UC26 | User canceled the transaction at the bank's reset password screen |
UC27 | User canceled the transaction because the bank was unavailable |
UC28 | User canceled the transaction at an external screen |
UC29 | User canceled the transaction due to a timeout |
UC30 | User canceled on the manual entry screen after an invalid routing or account number entry |
UC31 | User canceled on the manual entry screen due to related information (SWIFT code or address) not being found |
UC32 | User canceled the transaction at the maintenance page |
UC33 | User canceled the transaction at non-eligible currency error page |
UC34 | User canceled the transaction at Connect to your bank (OAuth login) page |
UC35 | User canceled the transaction at Waiting for your approval page |
UC36 | User canceled the transaction at VAN info page |
UC37 | User canceled the transaction at widget within Lightbox page |
Acknowledged Communication (AC)
These are the main statuses for ACH and RTP transactions. When user communication is completed or when the merchant calls API directly these are going to be set for the transaction.
Status Code | Description |
---|---|
AC100 | AC Pending |
AC101 | AC Declined |
AC102 | AC Approved |
AC103 | AC Error |
AC104 | AC Voided |
AC105 | AC Processed |
AC106 | AC Collected |
AC107 | AC Awaiting Capture |
AC108 | AC Awaiting Approval |
AC109 | AC Suspended |
AC110 | AC In Collection |
AC111 | AC In Research |
AC112 | AC Disputed |
AC113 | AC Uncollected, Insufficient Funds |
AC114 | AC Invalid or Closed Account |
AC115 | AC Other Returns |
AC116 | AC None |
AC117 | AC Expired |
AC118 | AC Settled |
System Error (SE)
Status Code | Description |
---|---|
SE01 | System in maintenance mode |
SE02 | System error connecting to API services |
SE03 | System error connecting to financial services gateway |
ACH Return Codes (R)
These statuses are related to ACH return codes.
Status Code | Description |
---|---|
R01 to R84 | ACH return codes 01 to 84. |
EFT Decline Codes - Canada
These statuses are related to ACH return codes.
Status Code | Description |
---|---|
900 | Account information incorrectly entered |
901 | Insufficient Funds |
902 | Account not Found |
903 | Payment Stopped/Recalled |
904 | Post/Stale Dated |
905 | Account Closed |
907 | No Debit Allowed |
908 | Funds Not Cleared |
909 | Currency/Account Mismatch |
910 | Payor/Payee Deceased |
911 | Account Frozen |
912 | Invalid/Incorrect Account No |
914 | Incorrect Payor/Payee Name |
915 | No Agreement Existed - Business/Personal Refused |
916 | Not in accordance with Agreement - Personal |
917 | Agreement Revoked - Personal |
918 | No Confirmation/Pre-Notification - Personal |
919 | Not in accordance with Agreement - Business |
920 | Agreement Revoked - Business |
921 | No Pre-Notification - Business |
922 | Customer Initiated Return - Credit Only |
990 | Institution in Default |
996 | Chargeback |
Trustly Direct Debit (TDD) for UK
These statuses are related to ACH return codes.
Status Code | Description |
---|---|
ARUCS_0 | Invalid details |
ARUCS_2 | Beneficiary deceased |
ARUCS_3 | Account transferred |
ARUCS_5 | No account |
ARUCS_B | Account closed |
ARUCS_C | Requested by remitter |
AWACS_0 | Invalid details |
AWACS_3 | Account transferred |
ARUDD_0 | Refer to payer (basically means out of funds) |
ARUDD_2 | Payer deceased |
ARUDD_3 | Account transferred |
ARUDD_4 | Advance notice disputed |
ARUDD_5 | No account (or wrong account type) |
ARUDD_6 | No instruction |
ARUDD_7 | Amount differs (disputed amount) |
ARUDD_8 | Amount not yet due (in case payment is sent before DDI confirmed) |
ARUDD_9 | Presentation is overdue |
ARUDD_A | Service User differs (Details dont match DDI) |
ARUDD_B | Account closed |
ADDACS_0 | Instruction canceled refer to Payer |
ADDACS_1 | Instruction canceled by Payer |
ADDACS_2 | Payer Deceased |
ADDACS_3 | Account transferred to new bank |
ADDACS_B | Account closed |
ADDACS_C | Account transferred to new branch |
ADDACS_D | Advance notice disputed |
ADDACS_E | Instruction amended |
ADDACS_R | Instruction re-instated |
AUDDIS_1 | Instruction Canceled by Payer |
AUDDIS_2 | Payer deceased |
AUDDIS_3 | Account transferred |
AUDDIS_5 | No Account |
AUDDIS_6 | No instruction |
AUDDIS_C | DDI amount not zero |
AUDDIS_F | Invalid account type |
AUDDIS_G | PSP will not accept DD on account |
AUDDIS_H | Instruction expired |
AUDDIS_I | Payer Reference not unique |
AUDDIS_K | Instruction cancelled by paying PSP |
AUDDIS_L | Incorrect payers account details |
AUDDIS_M | Trx code/user status incompatible |
AUDDIS_N | Trx not allowed at payers branch |
AUDDIS_O | invalid reference |
AUDDIS_P | Payer's name not present |
AUDDIS_Q | Service users name blank |
DDICA_1 | Amount differs |
DDICA_2 | No advance notice received by payer |
DDICA_3 | DDI canceled by bank |
DDICA_4 | Payer has canceled DDI with Service User |
DDICA_5 | No instruction held |
DDICA_6 | Signature fraudulent |
DDICA_7 | Claim raised at Service User Request |
DDICA_8 | Service user name disputed, payer does not recognize |
Payment Response Codes
Category | Response Code | Response Description | Suggested Actions |
---|---|---|---|
Status - New transaction | SW010 | Established | N/A |
Status - User canceled | SW013 | Canceled (user canceled the transaction) | Prompt user to try again (do not close the browser or app during the transaction.) For suggested copy see consumer messaging below. |
Status - Transaction authorized | SW020 | Authorization received | N/A |
Payment Decline Codes and Reason Codes
Some decline codes will be accompanied by a ReasonCode
and ReasonDescription
these fields can be used to inform your users the reason for decline and if some alternative actions are suggested. Additionally, in some cases one or more extended reason code
may be provided.
Sample Notification:
POST /{notification path}
Authorization: Basic TThSYUhnRWpCRTU0enVGWU1SUXE6RVlOM0dYYXNyVlUxdlExdXlZejIyTk5RZHk0PQ==
merchantId=00123&merchantReference=my+reference&paymentType=2&transactionType=3&eventId=1030845856&eventType=Deny&objectId=1025228290&objectType=Transaction&message=Not+enough+balance&createdAt=1714503865362&errorCode=331&isOverridePossible=true&shouldOverrideBeAvoided=true&paymentProviderTransaction.reasonCode=12&paymentProviderTransaction.reasonCodeMessage=Not+enough+balance&paymentProviderTransaction.status=SW021&paymentProviderTransaction.statusMessage=Not+enough+balance&paymentProviderTransaction.extendedReason.code=10000&paymentProviderTransaction.extendedReason.code=11000&status=8&statusMessage=Denied
BETA FeatureSome of the features below are still in Beta and may require configuration for your API credentials. Contact your Trustly representative for more information.
Testing in Sandbox
- Step 1: Create an authorization using Demo Bank.
- Username:<"anyusername">
- Password: extendedreasoncode_, as in ”extendedreasoncode_10000,"
- Step 2: Create a capture referring to the previously created authorize.
- Step 3: It is expected the transaction is denied by the Response Codes associated with the extended reason codes provided in the password.
- Step 4: The decline/fail notification should present the following attributes, among others:
- paymentProviderTransaction.status: SW054
- paymentProviderTransaction.reasonCode: 1
- paymentProviderTransaction.extendedReason.code: 10000
Authorization denied
Category | Status Code | Response Description |
---|---|---|
Decline | SW021 | Authorization denied |
Extended reasons for suspicious activity declines.
Reason Code | Reason Description | Extended Reason Code | Extended Reason Description | Consumer Decline Reason Details |
---|---|---|---|---|
12 | 120000 | Insufficient funds | Transaction unsuccesful. We are unable to complete your transaction due to insufficient funds in your account. Please a) add funds to your account, b) Use another account at the same bank, c) Or, sign into another bank. |
Suspicious Transaction Activity
Category | Status Code | Response Description |
---|---|---|
Decline | SW054 | Suspicious transaction activity |
Extended reasons for suspicious activity declines.
Reason Code | Reason Description | Extended Reason Code | Extended Reason Description | Consumer Decline Reason Details |
---|---|---|---|---|
1 | Exceeded thresholds | 10000 | Exceeded thresholds | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
1 | Exceeded thresholds | 10001 | Exceeded transaction amount | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
1 | Exceeded thresholds | 11XXX | Exceeded XXX hours consumer amount velocity limit (001 to 999) | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
1 | Exceeded thresholds | 12XXX | Exceeded XXX hours consumer count velocity limit (001 to 999) | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
1 | Exceeded thresholds | 13XXX | Exceeded XXX hours merchant amount velocity limit (001 to 999) | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
1 | Exceeded thresholds | 14XXX | Exceeded XXX days merchant count velocity limit (001 to 999) | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
2 | Data mismatch | 20000 | Consumer name data mismatch | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
2 | Data mismatch | 20001 | Consumer email data mismatch | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
2 | Data mismatch | 20002 | Consumer address data mismatch | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
3 | Suspicious History | 30000 | Suspicious History | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
3 | Suspicious History | 30101 | NSF ML risk model: Score higher than threshold | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
3 | Suspicious History | 30201 | NSF risk rules: Hard block based on attributes | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
3 | Suspicious History | 30301 | Fraud ML risk model: Score higher than threshold | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
3 | Suspicious History | 30401 | Fraud risk rules: Hard block based on attributes | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
4 | 3rd Party Suspicious History | 40000 | 3rd Party Suspicious History | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
Negative Database
Category | Status Code | Response Description |
---|---|---|
Decline | SW055 | Negative Data |
Reason Code | Reason Description | Extended Reason Code | Extended Reason Description | Consumer Decline Reason Details |
---|---|---|---|---|
5 | Negative Database | 50000 | Negative Database | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
5 | Negative Database | 50001 | Consumer blocklisted | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
5 | Negative Database | 50002 | Consumer's device blocklisted | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
5 | Negative Database | 50003 | Consumer's bank account blocklisted | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
5 | Negative Database | 50004 | Consumer's IP blocklisted | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
5 | Negative Database | 50005 | Consumer's geo location blocklisted | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
5 | Negative Database | 50006 | Uncollected debt: NSF | Transaction unsuccessful. We are unable to complete your transaction because one or more of the consumer's previous transaction(s) were not successful and funds are owed to Trustly. Please request the consumer to contact Trustly to pay for previous transactions to continue. |
5 | Negative Database | 50007 | Uncollected debt: Admin | Transaction unsuccessful. We are unable to complete your transaction because one or more of the consumer's previous transaction(s) were not successful as there was an error with bank. Please request the consumer to 1) contact Trustly to pay for previous transactions to continue, 2) login to the bank account again. |
5 | Negative Database | 50008 | Uncollected debt: SUF | Transaction unsuccesful. We are unable to complete your transaction because one or more of the consumer's previous transaction(s) were not successful and funds are owed to Trustly. Please request the consumer to contact Trustly to pay for previous transactions to continue. |
6 | Blocked Country | 60000 | Consumer's on sanctions list | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
7 | Blocked IP | 70000 | Consumer's on IP sanctions list | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
8 | 3rd Party Negative Database | 80000 | Consumer blocklisted by 3rd Party | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
16 | Unable to Communicate Reason | 160000 | Unable to communicate reason | Transaction unsuccessful: We're sorry. The transaction could not be completed and no further data is available. |
Invalid Account
Category | Status Code | Response Description |
---|---|---|
Decline | SW056 | Invalid Account |
Reason Code | Reason Description | Extended Reason Code | Extended Reason Description | Consumer Decline Reason Details |
---|---|---|---|---|
9 | Business Account Unsupported (Regulatory Reasons) | 90000 | Unsupported business bank account | Invalid Account: To comply with Federal, state, or local regulations, Trustly does not currently support this type of account. |
10 | AccountUnsupported (Regulatory Reasons) | 100000 | Unsupported non-checking bank account | Invalid Account: To comply with Federal, state, or local regulations, Trustly does not currently support this type of account. |
Expired Split Token
Category | Status Code | Response Description |
---|---|---|
Decline | SW057 | Expired Split Token |
Reason Code | Reason Description | Extended Reason Code | Extended Reason Description | Consumer Decline Reason Details |
---|---|---|---|---|
11 | Expired Split Token | 110000 | Expired/Revoked Split Token | Transaction unsuccesful: We're sorry. The transaction could not be completed because of a technical error on the bank's side. |
11 | Expired Split Token | 110001 | New authentication required due to suspicious activity | Transaction unsuccesful: We're sorry. The transaction could not be completed because of a technical error on the bank's side. |
Suggested Actions
Response Code | Reason Code | Suggested Actions |
---|---|---|
SW054 |
1 |
Please try again later or use a different bank account. |
SW054 |
2 |
Please ensure the user is using their own financial institution that matches with the merchant info. |
SW054 |
3 |
For suggested copy see consumer messaging below. |
SW054 |
4 |
For suggested copy see consumer messaging below. |
SW054 |
15 |
Please ensure that the beneficiary country is not listed among the prohibited countries for international money transfers. |
SW055 |
5 |
Please contact Trustly's merchant support team if the user escalates. |
SW055 |
6 |
For suggested copy see consumer messaging below. |
SW055 |
7 |
Please ensure the user is coming from a non-sanctioned country. For suggested copy see consumer messaging below. |
SW055 |
8 |
Please contact Trustly's merchant support team if the user escalates. |
SW056 |
9 |
Please prompt the user to use a personal debitable account. |
SW056 |
10 |
Prompt the user to use a personal debitable account. |
SW057 |
11 |
Please prompt the user to log in again. |
Payment Response Consumer Messaging
Use the following consumer codes and language in applicable user experiences and messaging.
Response Code | Consumer Decline Code | Consumer Decline Reason Details |
---|---|---|
SW013 | User Cancelled | This transaction was cancelled partway by you, your browser or your device. |
SW021 | Insufficient Funds | Transaction unsuccessful. We are unable to complete your transaction due to insufficient funds in your account. Please a) add funds to your account, b) Use another account at the same bank, c) Or, sign in to another bank |
SW051 | Merchant Error | Transaction unsuccessful: We're sorry. The transaction could not be completed because of a technical error on the merchant's side. |
SW052 | Bank Error | Transaction unsuccessful: We're sorry. The transaction could not be completed because of a technical error on the bank's side. |
SW053 | Network Error | Transaction unsuccessful: We're sorry. The transaction could not be completed because of a technical error from the network. |
SW054 | Security Controls | Security Alert: We detected some unusual activity and as a result, this transaction was not completed. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
SW055 | Security Controls | Security Alert: We detected some unusual activity and as a result, this transaction was blocked. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
SW056 | Unsupported Account Type | Invalid Account: To comply with Federal, state, or local regulations, Trustly does not currently support this type of account. |
SW059 | Security Controls | Security Alert: We detected some unusual activity and as a result, this transaction was not completed. To protect consumers and merchants, Trustly employs risk mitigation and fraud prevention tools to spot suspicious activity. Please see Trustly's FAQs for further information on Trustly's risk decisioning process. |
SW060 | Bank Error | Transaction unsuccesful: We're sorry. The transaction could not be completed because of a technical error on the bank's side. |
Payment Provider Types
Code | Description |
---|---|
1 | Online Banking |
2 | Manual Electronic Check |
Payment Types
Value | Name | Description |
---|---|---|
2 | Deferred | Deferred payment. Payment is authorized but the capture operation must be called to initiate the debit. You can start to initiate multiple captures that are less than or equal to the original transaction authorization amount. |
3 | Recurring | Recurring payment. Same as deferred but associated with a payment agreement between consumer and merchant that defines how much and when the capture can be started. |
4 | Disbursement | Disbursement payment. This payment type can only be used for disbursements. |
5 | Verification | This payment type is used to verify the customer financial institution account as the payments will be done outside of Trustly system. |
6 | Retrieval | Data retrieval. This payment type is used to retrieve account and user information from Trustly without an associated payment request. This payment type is not enabled by default. Contact Trustly if you need this feature. |
Transaction Status Values
Value | Name | Description |
---|---|---|
0 | New | This is the initial status after the transaction is created but before the consumer chooses a financial institution for payment. Transactions in the new state are visible only through Notification or the API status operations, not through the Merchant Portal. |
1 | Pending | Payment is pending. This is the initial transaction status when the consumer has the Pay Panel open but has not yet authorized the transaction. Transactions in the Pending state are visible only through Notification or the API status operations, not through the Merchant Portal. |
2 | Authorized | Payment was authorized by the consumer (they have selected their account and clicked ‘Pay') but the ACH has not yet been submitted for processing. |
3 | Processed | Transaction was processed. The ACH debit has been submitted to the ACH network after authorization by the consumer. |
4 | Completed | Transaction was paid, funds transferred. |
5 | Failed | Internal failure of transaction. (Unrelated to the merchant). |
6 | Expired | Pending transaction timed out before the consumer authorized the payment via the Pay Panel. |
7 | Canceled | Transaction was canceled by the consumer by closing the Pay Panel prior to the transaction being authorized or canceling the transaction from the Pay Panel. |
8 | Denied | Money transfer was denied, consumer account does not have enough funds. |
10 | Reversed | Payment was reversed (charged back by the bank or Trustly). |
11 | Partially Refunded | Payment was partially refunded. |
12 | Refunded | Payment was refunded. |
13 | Voided | Authorization was voided by the merchant. This occurs when the 'cancel' API is invoked or the transaction is canceled in the Merchant Portal (this must be done prior to the transaction being moved to ‘Processed' status). |
14 | OnHold | A transaction is put on hold after authorization if something is preventing the normal flow, such as when an ACH debit could not be initiated, or if the Trustly wants the merchant to verify that it really approves of this customer authorizing this amount. The payment may take longer to process than usual. Note: if a transaction is On Hold, you can verify it through the Merchant Portal to let it resume the normal flow of payment processing. Currently, there is no equivalent way to do that verification through the API. |
Transaction Types
Value | Name | Description |
---|---|---|
0 | External | This transaction is created when the Feedback API is called to update the status of a transaction created with a paymentType of Retrieval . |
1 | Authorize | This is a transaction created with paymentType is Deferred or Recurring . |
2 | Pay | This is a transaction created with paymentType of Instant . |
3 | Capture | Capture transactions are created with the Capture API. |
4 | Refund | Capture transactions are created with the Refund API. |
5 | Reverse | A reverse transaction is created when the payment is charged back by the bank (payment provider). |
6 | Deposit | Deposit transactions are created with the Deposit API. |
7 | Reclaim | Reclaim transactions are created with the Reclaim API. |
8 | Representment | A representment transaction represents an attempt to reprocess a previously denied Capture transaction. |
9 | Tokenization | |
10 | Preauthorization | Preauthorization transactions are created with the Preauthorization API. |
11 | Guarantee |
Verification Mode
Code | Name | Description |
---|---|---|
1 | VerifiedByMerchant | ... |
2 | ApprovedByMerchant | ... |
3 | VerifiedByTrustly | ... |
4 | AmountAuthorizedByMerchant | ... |
Verification Status
Code | Name | Description |
---|---|---|
1 | Automatic | Payment verification followed Trustly internal rules. |
2 | ToVerify | Payment transaction is held (status = OnHold ) for further investigation and approval by the merchant. |
3 | Verified | Payment was verified and approved by the merchant or Trustly (see Verification Mode). |
4 | Refused | Payment was denied by the merchant or Trustly after verification. |
Verification Types
Code | Name | Description |
---|---|---|
0 | Not Verified | The Account was not verified. |
1 | Micro-deposits | The Account was verified using a micro-deposit process. |
2 | Online Banking verification | The Account was verified using the Trustly Online Banking application. |
3 | Database verification | The Account was verified using the Trustly database or a Third Party Service. |
FCRA Verification Third Party Score Values
The table below maps Trustly Verification thirdParty
values to a related score
value.
Score | Description | Verified Mapping |
---|---|---|
0 | Failed RT validation. | 0 |
100 | Strong indication that this account is invalid for payments. | 1 |
200 | This account has recent non-bankable debts. | 2 |
300 | History of returns on the account. | 3 |
400 | No negative data on this account, but the format appears suspicious. | 4 |
500 | No data on this account or format. | 5 |
600 | Limited information on the account, but the format appears valid. | 6 |
700 | We have seen this account, but did not receive a final disposition on the transaction. | 7 |
800 | We have seen this account but not recently. | 8 |
900 | This account has been seen recently. | 9 |
999 | Highest confidence that this account is valid. | 10 |
Non-FCRA Verification Score Values
The table below maps Trustly non-FCRA Verification score
values to a related verified
value.
Score | Description | Verified Mapping |
---|---|---|
15 | Known bad bank account. | false |
20 | Unknown bank account, but format appears valid. | false |
25 | Unknown bank account, but format appears suspicious. | false |
35 | Bank account seen but transaction not yet settled (5 days). | true |
45 | Known good bank account. | true |
Financial Institution Account Type Values
Code | Description |
---|---|
-1 | Unknown |
0 | Other |
1 | Checking |
2 | Savings |
Financial Institution Account Profile Values
Code | Description |
---|---|
-1 | Unknown |
0 | Other |
1 | Personal |
2 | Business |
Updated 2 months ago