Create Customer Wallet

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This API endpont enables you to provide the customer wallet details, as required to be collected by Coinify due to the Travel Rule regulations.
If your system passes this information on behalf of the customer, the Payment Window will skip the related screens which will improve the customers' experience.

In case the customer is using a VASP as the source of their payment, i.e. wallet type is vasp, they can choose from the list of supported VASPs.

The API endpoint also enables you to have the fully self-hosted crypto payment checkout experience with your own custom UI on top of Coinify Payment API.

Check the the self-hosted checkout guide.

In the default setup where you redirect your customers to our Payment Window URL, passing the required customer's wallet info via this API endpoint will skip the relevant wallet UI screens on Coinify's Payment Window, removing friction and improving the end-user experience.

❗️

To be able to pass the customer wallet details, you must first create the customer's entry using the Create Customer API endpoint and acquire the customer's ID from the response, as stored in Coinify's sytem.

See more about the Travel Rule regulations and the default Payment Window flow with Travel Rule requested data here.

Path Params
string
required

The ID of the customer as returned by the Create Customer API endpoint response.

Body Params
string
enum
required
Defaults to self_hosted

Type of customer's wallet. Available options are:

  • vasp: wallet hosted on a centralised exchange or crypto service provider like Coinbase.
  • self_hosted: wallet in full control of the end-user.
Allowed:
string

Required when type is vasp. Get list of available VASPs from Get VASP list API endpoint.

string
required

Wallet currency. Check the cryptocurrencies available for a Payment Intent here.
The specified wallet currency must match the currency that customer is paying with.

string

Wallet address of the end-user from which the payment transaction is sent. Required when wallet type is self_hosted.

string

Tag or memo for applicable currencies. Optional.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json