Create a customer

post

https://api.checker.finance/v1/payments/customers

Create a new customer record.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

client_reference

string

length between 20 and 64

Optional client-provided identifier, unique per client. If omitted, Checker generates one (equal to the returned customer_id).

legal_name

string

required

Customer legal full name

customer_type

string

enum

required

Customer legal entity type. Not every provider supports INDIVIDUAL.

Allowed:

country

string

required

Incorporation country; ISO 3166-1 alpha-2 country code

string

required

phone

string

required

E.164 format (e.g. +14155551234)

address

object

required

kyb

object

Optional during customer creation (BUSINESS type). Required before onboarding.

kyc

object

Individual KYC block (INDIVIDUAL type only). Required before onboarding an individual.

Headers

Idempotency-Key

string

required

Idempotency key required on all write requests. Replaying the same key with the same body returns the original response.

X-Api-Key

string

required

Your API key

X-Timestamp

string

required

Request timestamp (ISO 8601 UTC), included in the signature payload

X-Nonce

string

required

Unique request nonce (e.g. UUID)

X-Signature

string

required

HMAC-SHA256 hex digest of {METHOD}\n{path}\n{query}\n{X-Timestamp}\n{body}, signed with your API secret. Path excludes the query string; use an empty string for query/body when absent.

Responses

201Created

400Bad request

401Unauthorized

409Conflict