Skip to content
>
Mode: standard
POSTv2/merchant/wallets/:id/spend/request

Submit a Spend Request

SDKpostMerchantWalletsSpendRequestByIdV2
Sends a request to spend funds from the merchant client wallet. Also used to convert funds between supported cryptocurrencies
AuthenticatedOAuthclientId/secret

Request

Body · path parameters

Responses

200 · 401 · 403

Wallets & Integration Scope

It is important to note that spend requests executed via the API can only be used with wallets created

by the same integration.


See this section for more information.

Spend Request Lifecycle

2-step flow
Step 1Submit a spend request

Specify the source wallet, the destination (address or currencyId for conversions), and the amount. CoinPayments returns a pending request with a unique id.

Step 2Confirm the request

Post a confirmation against the request id to actually broadcast it. This two-step flow gives you a window to validate or back out before funds move.

Currency Conversion

The create spend request endpoint can also be used to convert cryptocurrencies.

Address and Currency Validation

When sending funds to an address, make sure that the destination address matches the token/coin

that you are crediting.


If the currencies do not match, this may result in funds being stuck in the network or even lost.

Here's a simplified flow chart explaining the withdrawal/conversion flow:

Withdrawal Flowchart