Create customer

Step by step guide on how to create a customer.

Step 1 - Create Customer

Every transfer is completed on behalf of a customer. To create a customer, use a Create Customer endpoint.

Example:

curl -X POST https://api.getfractal.xyz/v0/customers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "beneficiary_type": "individual"
}'

Response:

{
  "customer_id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "[email protected]",
  "kycs": {
    "status": "pending",
    "kyc_flow_link": "text"
  }
}

You can now use customer_id to initiate a KYC session.

Step 2 - Know Your Customer

Every customer needs to go through KYC/KYB. To initiate a KYC session, use a Create KYC Session endpoint.

Example:

curl -X POST https://api.getfractal.xyz/v0/customers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "beneficiary_type": "individual"
}'

Response:

{
  "kycs": {
    "status": "pending",
    "kyc_flow_link": "https://link-to-kyc-provider.com"
  }
}

Once a customer completed KYC, their kycs.status will change to approved.