Request KYC documents using the Rebilly API

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

This topic describes how to request Know Your Customer (KYC) documents from customers using the Rebilly API. The KYC process compares customer data against data in documents to verify a match. For information on KYC and how to use it in the Rebilly UI, see KYC.

Prerequisites

To complete this guide, you need customer data. To obtain customer data, see Retrieve a customer or Upsert a customer.

Gathering docs

1. Create a PostKycRequest.

   The following is a sample request body.

   {
     "documents": [
       {
         "type": "identity-proof",
         "faceProofRequired": true
       }
     ],
     "redirectUrl": "http://example.com",
     "customerId": "abc123"
   }

   The following is a sample response body.

   {
     "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
     "documents": [
       {
         "type": "identity-proof",
         "maxAttempts": 3,
         "faceProofRequired": true
       }
     ],
     "status": "pending",
     "redirectUrl": "http://example.com",
     "expirationTime": "2022-08-24T14:15:22Z",
     "createdTime": "2022-08-24T14:15:22Z",
     "updatedTime": "2022-08-24T14:15:22Z",
     "customerId": "abc123",
     "reason": "",
     "matchLevel": 2,
     "_links": [
       {
         "rel": "self",
         "href": "https://example.rebilly.com"
       },
       {
         "rel": "kycGatherer",
         "href": "https://verification.comply.services/?token=123"
       }
     ]
   }

   If the response status is fulfilled the process is complete, which might happen with an instant process such as a credit file lookup. The response includes a related link kycGatherer resource in the _links collection. Use the corresponding href value in the next step.

2. Redirect the customer to the href value of that kycGatherer link. When the customer completes the process, they return to the redirectUrl with an info query parameter appended to the URL.

Webhooks

Use webhooks to stay updated about the status of KYC documents. Subscribe to these events:

• KYC request fulfilled
• KYC document modified
• KYC document reviewed
• KYC document accepted
• KYC document rejected

Learn more about webhooks