KYSync

KYSync is a single shot KYC, KYB, and fraud prevention solution by deposits.com. It allows you to verify identities in one single API call, instantly.

Getting Started

Before you can start using KYSync to verify identities, you will need to first be approved to use the service by a sales/customer service team member and have a valid API key from your deposits developer dashboard.

post
Verify an Individual

https://client.user.swys.xyz/api/v1/kysync/verify-user
When verifying an individual identity, it is important to note that a result may not always be instantly available. If this is the case, a result_pending status will be provided along with the request ID. Please save this requestID in the database to the individual’s profile. Wait a couple of minutes and then request the result from the kysync/check-kyc endpoint.
Request
Response
Request
Body Parameters
apikey
required
string
first_name
required
string
last_name
required
string
ssn
required
string
date_of_birth
required
string
address
required
string
city
required
string
state
required
string
zipcode
required
string
Response
200: OK
{
"status": "success",
"message": "KYC sent for verification",
"data": {
"request_id": "FrgnkEy7zkqDAulVLzyZHHByo5dOv1Nk"
}
}

post
Check KYC

https://client.user.swys.xyz/api/v1/kysync/check-kyc
This endpoint allows you to check if an individual has been verified.
Request
Response
Request
Body Parameters
apikey
required
string
request_id
required
string
Response
200: OK
{
"status": "success",
"message": "KYC sent for verification",
"data": {
"request_id": "twBqV0qzDa7sdWnggTU2MrtzJfcVPNDk",
"verification_status": "FAIL",
"failure_reason": "ssn_mismatch",
"request_time": "2021-06-28T17:02:49.000Z",
"individual_details": {
"first_name": "James",
"last_name": "Lomo",
"individual_address": "no 19 sales avanue",
"individual_city": "baltimore",
"individual_state": "MD",
"individual_zipcode": "30098",
"individual_country": "US"
},
"validated_individual_address": {
"primary_number": "NO",
"street_direction": "",
"street_name": "19 SALES AVANUE",
"street_suffix": "",
"secondary_designator": "",
"secondary_number": "",
"city": "BALTIMORE",
"state": "MD",
"zip": "",
"county": "",
"longitude": null,
"latitude": null,
"address_type": "",
"building_type": "",
"mail_deliverability": "undeliverable"
},
"individual_ofac_check": {
"ofac_status": null,
"ofac_result": null
}
}
}

post
Verify Business

https://client.user.swys.xyz/api/v1/kysync/verify-business
Before you attempt to verify a business, it is important to note that you are required to have a webhook set up in your developer account. This is because results are not always instantly available. It may take up to 30 minutes on a weekday and up to 24hrs on a weekend. When the result becomes available, we need a location to send that to. If you successfully make a request to the KYB endpoint and do not receive any error messages in response to your request, you would receive a response containing a request_id. Please save that request_id in your database to the business’s profile as that is the only way to later link a result and a business.
Request
Response
Request
Body Parameters
apikey
required
string
business_name
required
string
business_city
required
string
business_state
required
string
business_zipcode
required
string
business_country
required
string
id_type
required
string
ein
optional
string
incorporated_date
required
string
incorporated_state
required
string
Response
200: OK
{
"status": "success",
"message": "KYC sent for verification",
"data": {
"request_id": "FrgnkEy7zkqDAulVLzyZHHByo5dOv1Nk"
}
}