Create a customer

post
Creates a customer

https://business-sandbox.cryptopay.me/api/customers
This endpoint allows you to create customers.
Request
Response
Request
Headers
Authorization
required
string
HMAC using API key and signature
Content-Type
required
string
application/json
Date
required
string
Current date in HTTP-date format
Body Parameters
id
required
string
The customer's reference ID in your system
currency
required
string
The customer's currency in your system. See the list of supported currencies on the left
refund_addresses
optional
object
This object allows you specify 1 cryptocurrency address for each type of supported cryptocurrencies i.e. BTC, ETH, XRP, LTC and BCH. In case Cryptopay detects a High-Risk transaction, such transaction will not be processed. Instead, it will be sent to the address specified for respective cryptocurrency. If you do not specify any addresses here, High-Risk payments will be put on hold. Refer to Invoice and ChannelPayment statuses for more information
Response
201: Created
Customer created
{
"data": {
"id": "e7bb04fb-7f33-4729-819e-05a92761b492",
"currency": "EUR",
"refund_addresses": {
"BCH": "2NC9kejEzarTeMdjGGn7Ykr8NUnjsxg3eup",
"BTC": "2MxXquVjWrWWHGpxYkNSXn5gmQd6YKUSybz",
"ETH": "0x613d91c46fa675d93d3825acf9ef651263063ccb",
"LTC": "QV8R26mTicPFCHWZN27r18VgTcch4eKQvE",
"XRP": "rhqxpAYXVSFvKBjWcCxoF5o3pCEYZqqMVC?dt=89647"
}
}
}

API call example.

curl -X POST \
https://business-sandbox.cryptopay.me/api/customers \
-H 'Authorization: HMAC ***' \
-H 'Content-Type: application/json' \
-H 'Date: Tue, 19 Mar 2019 10:11:40 GMT' \
-d '{"id":"e7bb04fb-7f33-4729-819e-05a92761b492", "currency":"EUR", "refund_addresses":{"BTC":"2MxXquVjWrWWHGpxYkNSXn5gmQd6YKUSybz", "ETH":"0x613d91c46fa675d93d3825acf9ef651263063ccb", "XRP":"rhqxpAYXVSFvKBjWcCxoF5o3pCEYZqqMVC?dt=89647", "LTC":"QV8R26mTicPFCHWZN27r18VgTcch4eKQvE", "BCH":"2NC9kejEzarTeMdjGGn7Ykr8NUnjsxg3eup"}}'

Response schema.

Parameter

Type

Description

id

string

The customer's reference ID in your system

currency

string

The customer's currency in your system

refund_addresses

object

The list of refund addresses where Cryptopay will refund High-Risk transactions to