POST
/api/v2/crypto-virtual-accounts/transfers/{transferId}/decisionRespond to a changed the crypto on/off-ramp quote
Use approve or decline while the transfer awaits quote approval. After decline, use keep to leave funds at the crypto on/off-ramp or return to send them back to the recorded source; provider/network return costs are reported when the crypto on/off-ramp supplies them.
Authentication
Send your API key in the x-api-key header on every request.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| transferId (path) | integer (int32) | Yes |
Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
| UserId | unknown | No | |
| Decision | string | Yes |
Responses
200 — OK
| Field | Type | Required | Description |
|---|---|---|---|
| Id | unknown | No | |
| Status | string | No | |
| BoomFiVirtualAccountId | string | No | |
| CryptoCurrency | string | No | |
| CryptoAmount | string | No | |
| ChainId | unknown | No | |
| FiatCurrency | string | No | |
| BoomFiOrderId | string | No | |
| BoomFiQuoteId | string | No | |
| BoomFiOrderStatus | string | No | |
| BoomFiSettlementStatus | string | No | |
| ToAmount | string | No | |
| EffectiveRate | string | No | |
| FailureMessage | string | No | |
| SlackChannelId | string | No | |
| SlackThreadTs | string | No | |
| SlackPermalink | string | No | |
| CompletedAt | string (date-time) | No | |
| CompletionMessage | string | No | |
| TransferDirection | string | No | |
| InitialExchangeRate | string | No | |
| InitialFeeAmount | string | No | |
| InitialFeeCurrency | string | No | |
| CurrentFeeAmount | string | No | |
| CurrentFeeCurrency | string | No | |
| RateDeviationPercent | unknown | No | |
| AutoExecutionTolerancePercent | unknown | No | |
| QuoteDecisionStatus | string | No | |
| QuoteExpiresAt | string (date-time) | No | |
| FundsDecision | string | No | |
| ReturnFeeAmount | string | No | |
| ReturnFeeCurrency | string | No | |
| SourceTransferId | string | No |
400 — Bad Request
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
401 — Unauthorized
| Field | Type | Required | Description |
|---|---|---|---|
| Message | string | No | |
| Code | string | No | |
| Status | unknown | No | |
| ValidationErrors | object | No | |
| Details | string | No |
Example request
curl -X POST "https://{base_url}/api/v2/crypto-virtual-accounts/transfers/{transferId}/decision" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"Decision":"…"}'This page is generated from the live OpenAPI specification and always matches the current API.