You must create the user before to submitting customer data for KYC approval

Required user data

You must submit the following user data:

  • Date of Birth

  • ID type (SSN)

  • ID Number

  • Address Line 1

  • Address Line 2

  • City

  • State

  • Postal Code

You should not store this information. It should be sent directly to Ratio from your front-end application.

Initiate KYC

KYC results

You have two options to notify the user the outcome of their KYC:

  1. Poll for status:

    • Approved

    • Declined

    • In Review

  2. Listen for the KYC event "KYC_UPDATED" in our webhooks

You should limit the amount of times you poll. Suggested (10 times, every 2 seconds) and retry if needed

There are 3 common reasons why KYC status could = In Review:

  1. The user has mistyped their Date of Birth

  2. The user has recently moved, and therefore the address provided does not match the addresses available from our underlying data providers

  3. The user has created an account using a phone number that is not under their name

If we cannot match any customer-provided information with their SSN you will receive a status of Declined. In most cases, when no customer information can be matched to the provided SSN, this is not a real user. This will not generate an end user support case.

Next steps

After KYC'ing a user, you need to link and verify a bank account, and assign a deposit address, before you can initiate an ACH transfer:

You are free to complete the remaining tasks in any order, however we recommend assigning the deposit address first (if you haven't already), and then linking their bank account.

You have two options to notify the user the outcome of their bank verification:

  1. Poll for status:

    • Link status = Active

    • Verification status = Approved

    • If Vefification stauts = Declined stop polling and present error.

  2. Listen for the bank verification event "BANK_UPDATED" in our webhooks

Last updated