Tokenize an account

curl -X POST https://sandbox.trustly.one/api/v1/accounts/tokenize \
     -H "Content-Type: application/json" \
     -u "<username>:<password>" \
     -d '{
  "merchantId": "110005502",
  "account": {
    "accountNumber": "123456576",
    "routingNumber": "124003116",
    "type": 1
  }
}'

{
  "name": "string",
  "type": -1,
  "profile": -1,
  "verification": {
    "verified": true,
    "type": 1,
    "hasEnoughFunds": true,
    "verificationDate": 1
  },
  "accountNumber": "string",
  "token": "string",
  "verified": true,
  "account": {
    "accountNumber": "1000000009",
    "country": "US",
    "routingNumber": "123456789",
    "type": 1,
    "verification": {
      "type": 4,
      "verificationDate": 1623322586771,
      "verified": false
    }
  }
}

Convert legacy ACH ABA routing and account numbers or an International Bank Account Number (IBAN) into a verified token to meet NACHA requirements.

Authentication

AuthorizationBasic

Query parameters

verifyAccountbooleanOptionalDefaults to false

If true, Trustly will verify the provided account data. Default value is false.

Request

This endpoint expects an object.

merchantIdstringRequired>=1 character

accountobjectRequired

Response

namestring>=1 character

Account name.

typeenum

Financial Institution Account Type:

-1: Unknown
0: Other
1: Checking
2: Savings

Allowed values:

profileenum

Financial Institution Account Profile:

-1: Unknown
0: Other
1: Personal
2: Business

Allowed values:

verificationobject

accountNumberstring1-4 characters

Financial institution account number

tokenstring>=1 character

Account token for the returned account. This can be used to identify duplicate bank accounts in your system.

verifiedboolean

If true, the account is verified.

nameOnAccountstringOptional>=1 character

Account owner name.

routingNumberstringOptional1-17 characters

Bank Routing Number provided by the selected account.

ibanstringOptional>=1 character

IBAN (International Bank Account Number) is an internationally agreed system of identifying bank accounts across national borders

accountIdstringOptional

providerIdstringOptional

paymentProviderobjectOptional

Details of the Financial institution

countryenumOptional

2-character ISO code of the country for the bank account that was selected. Currently only the US, CA, UK, DE, and AU are supported.

Allowed values:

Errors

400

Bad Request Error