Customers

A customer is the business or individual you collect from or pay on behalf of. Every transaction references one. Customers run through KYB before money movement is allowed.

Create

POST /v1/customers · Auth: X-API-Key

curl -X POST "$BASE_URL/v1/customers" \
  -H "X-API-Key: $THIQWAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "business",
    "legal_name": "Al Rashid Trading LLC",
    "email": "finance@alrashid.ae",
    "country": "AE",
    "verification_level": "standard",
    "tax_id": "TRN-100234567890003"
  }'

Field	Required	Notes
type	yes	business | individual
legal_name	yes	max 256
email	yes	unique per application
country	yes	ISO 3166-1 alpha-2
verification_level	yes	standard | enhanced
tax_id	yes	TRN/VAT/CRN, max 64

:::info TEST On TEST, KYB is mocked and approves instantly. On LIVE a real KYB vendor runs (kyb_status: pending → verifying → approved | rejected). :::

List / Get

curl "$BASE_URL/v1/customers?limit=25&status=approved" -H "X-API-Key: $THIQWAVE_API_KEY"
curl "$BASE_URL/v1/customers/$CUSTOMER_ID"          -H "X-API-Key: $THIQWAVE_API_KEY"

Cursor pagination: response next_cursor → next request ?cursor=….

Next steps

• Beneficiaries · Reference