SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-09
Browse: SET Merchant API

SET Merchant API · Customers

Send more KYB or KYC data

POST/v1/customers/{id}/kyb

Key scope: write

More or corrected verification data for a customer the provider already holds, whether it was created by API or by hosted link. The answer is the customer with requirementsDue read back.

Merchant key A merchant key verifies only its registered legal name: a different businessLegalName is 409 merchant_name_mismatch.

Path parameters

id stringrequired
The customer's id.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

kyb object
A business's further or corrected details, in the same fields as POST /v1/customers.
kyc object
An individual's further or corrected details.

Notes

  • Only the provider's own customer fields pass; anything else is 400 field_not_used. Nothing is stored or logged: the data goes to the provider in the request.

Errors

  • 400 kyb_invalid
  • 400 field_not_used
  • 400 kyb_incomplete
  • 400 kyb_refused
  • 403 prohibited_activity
  • 404 customer_unknown
  • 409 customer_not_created
  • 409 merchant_name_mismatch
  • 413 payload_too_large
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.