KYC

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 
post
https://api.ratio.me
/v1/users/{userId}/kyc
This initiates the KYC process for a user
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:
​Assign deposit address​
If you used wallet as the primary user authentication factor, then we have already set that as the deposit address. You can set additional deposit addresses as needed.
​Have a verified bank account​
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.
get
https://api.ratio.me
/v1/users/{userId}/banks/{bankId}
Get a Bank Account by ID for a user
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​

Assign a Deposit Address

Link and Verify a Bank Account

Last modified 21d ago