Create a customer
Creates an individual or business customer under the current tenant account.
What this endpoint does
Creates an individual or business customer under the current tenant account.When to use it
Create the customer before issuing verification or customer-owned payment routes.Before you call
Use a secret API key with customer write access and supply a stable external reference or identity fields required by the request schema.Money and balance effect
This changes a resource or configuration but does not directly reserve, debit, credit, or settle wallet money.States and completion
Creation does not approve the customer. Verification and entitlements progress asynchronously.Safe retries
Send a uniqueIdempotency-Key for the logical action. If the response is lost, retry the same payload with the same key; never create a new key merely because the first response timed out.
Read Customers for the complete workflow.Authorizations
Send the same Wayex API key as Authorization: Bearer <key>.
Headers
A unique key for this logical action. Reuse the same key and identical payload when retrying after an unknown response.
8 - 255Body
- Option 1
- Option 2
- Option 3
Response
The created customer.
Unique Wayex identifier for this customer.
1The client account (counterparty) this customer belongs to. For API callers this is always your own account id.
1Whether the customer is an individual (natural person) or a business (legal entity).
individual, business Current verification state. Value can only move on the customer's behalf once approved.
in_progress, approved, rejected, requires_action The capabilities this customer is cleared for, granted as verification completes.
When the customer was created (ISO 8601).
Your own identifier for this customer, echoed back for cross-referencing.
1
