accounts

Tokenize an account

Changed on

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

post/accounts/tokenize

Request

  • Base URL
    https://sandbox.trustly.one/api/v1
  • URL
    https://sandbox.trustly.one/api/v1/accounts/tokenize
  • Auth
    HTTP basic

Query parameters

verifyAccountboolean

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

Request body

merchantIdstring required

Response

OK

nameOnAccountstring

Account owner name.

namestring required

Account name.

type'-1' | '0' | '1' | '2' required

Financial Institution Account Type:

  • -1: Unknown
  • 0: Other
  • 1: Checking
  • 2: Savings
profile'-1' | '0' | '1' | '2' required

Financial Institution Account Profile:

  • -1: Unknown
  • 0: Other
  • 1: Personal
  • 2: Business
accountNumberstring required

Financial institution account number

routingNumberstring

Bank Routing Number provided by the selected account.

ibanstring

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

tokenstring required

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

accountIdstring
providerIdstring
verifiedboolean required

If true, the account is verified.

country'US' | 'CA' | 'UK' | 'DE' | 'AU'

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.

Changes

    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security HTTPBasic was added to the API

    • info

      api operation id post-accounts-tokenize?-verifyAccount removed and replaced with accounts_post-accounts-tokenize?-verifyAccount