Create Customer

post

https://api.payment.sandbox.coinify.com/v1/customers

This endpoint allows you to create a customer entry in Coinify system. Due to Travel Rule regulatory requirements, Coinify must collect this data for every customer. In case the customer does not give consent to share this data with Coinify and/or you do not provide it via this API endpoint, Coinify will collect this data directly from the customer as a part of the usual payment flow. See more info regarding Travel Rule and the data collection here.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

👍
Please contact [email protected]
so that we can start the process of enabling this endpoint for you.
It is not possible to use Customer endpoints without the prior approval.

🚧
Make sure to get customer's consent to share the required data with Coinify before doing so.

❗️
Make sure to store the id returned by the endpoint
This is the customer ID as stored in the Coinify's system. You will need it to e.g. pass the coinifyCustomerId when creating the Payment Intent, Read Customer's wallets info, Create Customer Wallet etc.

Body Params

name

string

required

Defaults to Customer name

Full name of the customer.

string

required

Defaults to [email protected]

Email of the customer.

country

string

required

Defaults to DK

The residence country of the customer. ISO 3166-1 alpha-2

subdivision

string

Country subdivision. Required if there's subdivisions within a country. E.g. if country is US then this field is required to provide the exact residence state of the customer.

address

string

required

Defaults to Residence address

Address of the customer.

type

string

required

Defaults to individual

Type of the customer. Available values: "individual" or "business"

dateOfBirth

date

Required if "type" = "individual". Format "YYYY-MM-DD".

legalEntityIdentifier

string

Required if "type" = "business". The legal identifier of the business. E.g. VAT number in EU.

privacyConsent

boolean

Can be "true" or "false". Specifies if the customer agreed with your Privacy Terms where you specify that you can share their data with Coinify for Travel Rule purposes. Or if you have received direct consent from the customer to share their data with Coinify.

Responses

200

Create Customer

Please contact `[email protected]`

Make sure to get customer's consent to share the required data with Coinify before doing so.

Make sure to store the `id` returned by the endpoint

Please contact [email protected]

Make sure to get customer's consent to share the required data with Coinify before doing so.

Make sure to store the id returned by the endpoint

201Created

400Bad Request

401Unauthorized

403Forbidden

422Unprocessable Entity

Please contact `[email protected]`

Make sure to store the `id` returned by the endpoint