Define full invoice crypto-currency

Defines cryptocurrency for the created full invoice

POST https://app.thedex.cloud/api/v1/invoices/currency

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

{
    "invoiceId": "String",
    "payCurrency": "String"
}

Request JSON attributes

Name	Type	Description
invoiceId*	String	ID of Invoice for defining
payCurrency*	String	required reach out all accessed values by link: /api/v1/info/currencies

Response body

200 defined crypto-currency invoice

{
   "invoiceId": "String",
   "purse": "String",
   "amount": "String",
   "currency": "String",
   "amountInPayCurrency": "String",
   "payCurrency": "String",
   "blockchainFee": "String"
}

400

General validation error: missing or malformed parameters.

{
    "error": "Bad Request",
    "status": 400,
    "timestamp": "2026-01-01 00:00:00",
    "message": "payCurrency: following value doesn't valid. "
}

422

Specific field validation error. (Minimal limits, etc)

{
    "error": "Unprocessable Entity",
    "status": 422,
    "timestamp": "2026-01-01 00:00:00",
    "message": "Minimal limit amount doesn't exceed"
}

{
    "error": "Unprocessable Entity",
    "status": 422,
    "timestamp": "2026-01-01 00:00:00",
    "message": "Requested payCurrency is not active"
}

{
    "error": "Unprocessable Entity",
    "status": 422,
    "timestamp": "2026-01-01 00:00:00",
    "message": "Currency has been applied already"
}

401

When try to define payCurrency for another merchant invoice.

{
    "error": "Unauthorized",
    "status": 401,
    "timestamp": "2026-01-01 00:00:00",
    "message": "Request is not authorized: The requested merchant is not allowed to work with the current invoice"
}

500

Not found invoice, blockchain or server side problem.

{
    "error": "Internal Server Error",
    "status": 500,
    "timestamp": "2026-01-20 04:16:55",
    "message": "Cannot process pay currency for the invoice"
}

Response JSON attributes

"invoiceId"	String	Invoice id
"purse"	String	Purse
"amount"	String	Amount of fiat currency
"currency"	String	reach out accessed values by link: /api/v1/info/currencies
"amountInpayCurrency"	String	Amount of cryptocurrency after convertion
"payCurrency"	String	reach out accessed values by link: /api/v1/info/currencies
"blockchainFee"	String	Deposit blockchain fee

Curl request

curl --location --request POST 'https://app.thedex.cloud/api/v1/invoices/currency' \
--header 'X-EX-APIKEY: <string>' \
--header 'X-EX-PAYLOAD: <string>' \
--header 'X-EX-SIGNATURE: <string>' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
  "invoiceId": "<string>",
  "payCurrency": "<string>"
}'

Example Curl

curl --location --request POST 'https://app.thedex.cloud/api/v1/invoices/currency' \
--header 'X-EX-APIKEY: test_api_key_123' \
--header 'X-EX-PAYLOAD: eyJpbnZvaWNlSWQiOiAiSU5WMTIzNDU2IiwgInBheUN1cnJlbmN5IjogIkJUSyJ9' \
--header 'X-EX-SIGNATURE: d4f7e3d2870f18c3c89a1d32aa98e8b5f1a8a9d47ac3b0b0d991b7b5d7d0c0ff' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--data '{
  "invoiceId": "INV123456",
  "payCurrency": "BTK"
}'