Verify Customer KYC using a Partner's existing KYC infrastructure and create a new customer account if one does not exist. The Coinme compliance team will review the use of the Partner's existing KYC program, which is subject to approval.

For staging, the Customer Onboarding URL is https://secure.apis.coinme.org/services/customeronboarding

For production, is https://secure.apis.coinme.com/services/customeronboarding

Assumptions:

• The Partner should perform 2FA and ensure it is passed. They should not send onboarding requests if 2FA is not passed.

Sample API Request: POST

URL: https://secure.apis.coinme.org/services/customeronboarding
headers:
"Authorization":"asdfghj", //authorization token,required
'User-Agent: partnerapi' //required
Request body:
{
  "email": "[email protected]", // required
  "fullName": {
    "firstName": "TestFirst", // required
    "middleName": "TestMiddle",
    "lastName": "TestLast", // required
    "otherNames": [
      "secondLastName",
      "otherName1",
      "otherName2"
    ]
  },
  "address": {
    "line1": "1234 Example St", // required
    "line2": "Apt 4",
    "city": "Foo City", // required
    "state": "CA", // required
    "postalCode": "93420", // required
    "country": "USA" // required, 3-character abbreviation
  },
  "phoneNumber": {
    "countryCode": "1", // required
    "number": "8001234567" // required
  },
  "dateOfBirth": "1965-02-10", // required
  "SSN": "123-123-1234" // required
}

Sample API Response:

Successful Response:
{
  "data": 
  {
    "customerId": "654987321"
  },
  "errorResponse": null
}

Failure Response:
{
  "data": null,
  "errorResponse": {
    "httpStatus":"200",
    "timestamp":"2022-02-01T18:59:28.297Z",//UTC
    "path":"/services/customeronboarding POST",
    "errorData": [
      {
        "errorCode":"123-123-123-123",//The error code is just a sample showing the structure of the error code.
        "message":"Customer identity could not be validated"
      }
    ],
    "retry":"N"
  }
}

Error Codes