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": "987654321",
    "routingNumber": "021000021",
    "nameOnAccount": "Alice Johnson",
    "country": "US"
  }
}'

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

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

merchantIdstringRequired>=1 character

accountobjectRequired

Response

namestring>=1 character

Account name.

typeenum

Financial Institution Account Type:

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

profileenum

Financial Institution Account Profile:

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

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.

nameOnAccountstring>=1 character

Account owner name.

routingNumberstring1-17 characters

Bank Routing Number provided by the selected account.

ibanstring>=1 character

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

accountIdstring

providerIdstring

paymentProviderobject

Details of the Financial institution

countryenum

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.

Errors

400

Bad Request Error