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

SET Merchant API · Customers

Add an owner, director or signer

POST/v1/customers/{id}/associated_persons

Key scope: write · Success: 201

One more associated person on a business customer: a beneficial owner, a director, a controller or a signer.

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

<person> objectrequired
The person in camelCase: firstName, lastName, middleName, email, phone, birthDate, title, residentialAddress, nationality, hasOwnership, ownershipPercentage, hasControl, isSigner, isDirector, identifyingInformation, documents and the provider's other associated-person fields.

Errors

  • 400 kyb_invalid
  • 400 field_not_used
  • 400 kyb_refused
  • 404 customer_unknown
  • 409 customer_not_created
  • 409 not_a_business
  • 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.