Start buyer KYC via the settlement partner - Caratuva

Start buyer KYC via the settlement partner

curl --request POST \
  --url https://api.example.com/v1/buyer-kyc \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

POST

/

v1

/

buyer-kyc

Start buyer KYC via the settlement partner

curl --request POST \
  --url https://api.example.com/v1/buyer-kyc \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{}'

Authorizations

X-API-Key

string

header

required

Body

application/json

The body is of type object.

Response

201

Buyer KYC submission created

Reset onboarding for the caller's active mode (test mode only)Mint a settlement-partner ToS-acceptance session URL. Direct your buyer to the returned URL; on acceptance the settlement partner redirects to your redirectUrl with ?tos_id=...&idempotency_key=... query params. Then call /tos-accepted (or pass tosId in the next /buyer-kyc submit).