Create static wallet

Creates a static wallet address — a single, unchanging address used to receive payments in a specified cryptocurrency.

POST https://app.thedex.cloud/api/v1/wallets/create

Headers

Name	Type	Description
X-EX-APIKEY*	String	Your API key
X-EX-PAYLOAD*	String	Body to base64
X-EX-SIGNATURE*	String	Encrypted body with the secret key

Request Body

{
    "clientId": "String",
    "monetary": "String",
    "merchantId": "String",
    "fiatCurrecy": "String", //optional
    "successUrl": "String", // optional
    "failureUrl": "String", // optional
    "callbackUrl": "String" // optional
}

Request JSON attributes

Name	Type	Description
monetary*	String	Wallet monetary (cryptocurrency)
merchantId*	String	You can find it on page 'Merchants' in your account
clientId*	String	An arbitrary identifier for the client
fiatCurrency	String	Default = USD Reach out all available fiat currencies by endpoint: /api/v1/info/currencies Primary Used for recalculation of paid_amount_fiat.
successUrl	String	Custom successUrl for an invoice, that can be differ from merchant settings
failureUrl	String	Custom failureUrl for an invoice, that can be differ from merchant settings
callbackUrl	String	Custom callback url for receiving events about created invoice on wallet

Response Body

200 created wallet

{
    "walletId": "String",
    "monetary": "String",
    "clientId": "String",
    "fiatCurrency": "String",
    "successUrl": "String",
    "failureUrl": "String",
    "callbackUrl": "String",
    "address": "String",
    "minAmount": "String",
    "isActive": "Boolean",
    "payUrl": "String",
    "qrBase64": "String"
}

400

422

401

500

Response JSON attributes

"walletId"	String	Unique identifier of the created wallet
"monetary"	String	Cryptocurrency of the created wallet
"clientId"	String	Arbitrary identifier of the client
"fiatCurrency"	String	Wallet currency used for paid_amount_fiat
"successUrl"	String	Success url to redirect customer after successful payment
"failureUrl"	String	Failure url to redirect customer after failed payment
"callbackUrl"	String	Callback url to receive webhook about created invoices after successful / failed deposit of wallet
"address"	String	Generated crypto address for accepting payments
"minAmount"	String	Minimum amount required to accept a payment
"isActive"	Boolean	Indicates whether the wallet is active.
"payUrl"	String	Pay url
"qrBase64"	String	A Base64-encoded PNG image of a QR code that encodes the wallet address for payment

Request curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/wallets/create' \
--header 'X-EX-APIKEY: <string>' \
--header 'X-EX-PAYLOAD: <string>' \
--header 'X-EX-SIGNATURE: <string>' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
    "monetary": "String",
    "merchantId": "String",
    "fiatCurrency": "String",
    "clientId": "String",
    "successUrl": "String",
    "failureUrl": "String",
    "callbackUrl": "String"
}'

Example Curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/wallets/create' \
--header 'X-EX-APIKEY: test_api_key_123456' \
--header 'X-EX-PAYLOAD: eyJtb25ldGFyeSI6IkJUSDIiLCJtZXJjaGFudElkIjoiTVJDSEFOVDEyMyIsImNsaWVudElkIjoiQ0xJRU5UMTIzIiwic3VjY2Vzc1VybCI6Imh0dHBzOi8vdGVzdC5zdWNjZXNzIiwiZmFpbHVyZVVybCI6Imh0dHBzOi8vdGVzdC5mYWlsdXJlIiwiY2FsbGJhY2tVcmwiOiJodHRwczovL3Rlc3QuY2FsbGJhY2sifQ==' \
--header 'X-EX-SIGNATURE: dummy_signature_abc123' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
    "monetary": "BTC_BITCOIN",
    "merchantId": "MERCHANT123",
    "clientId": "CLIENT123",
    "fiatCurrency": "USD",
    "successUrl": "https://test.success",
    "failureUrl": "https://test.failure",
    "callbackUrl": "https://test.callback"
}'