Skip to main content

Cancel a payout that has not been sent

POSThttps://api.radom.com/payout/{id}/cancel

Only a payout awaiting confirmation (or an expired one) can be cancelled. It reads Expired from now on and nothing is debited for it. A payout whose stablecoin purchase or funding conversion has already started is refused.

Authorization

Send your API key in the Authorization header. Scheme: radomToken.

Parameters

idstring<uuid>pathrequired

Responses

200Payout cancelled
idstring<uuid>required
statusPayoutStatusrequired
AllowedAwaitingConfirmationPendingProcessingCompleteExpiredInReviewConvertingFailed
isTestModebooleanrequired
accountTypePayoutAccountTypenullable
Allowedbusinessindividual
deductFeesbooleanrequired
sendEmailReceiptsbooleanrequired
totalAmountUsdnumber<float>required
estimatedFeeUsdnumber<float>required
actualFeeUsdnumber<float>nullable
entryCountinteger<int32>required
fundingCurrencystringnullable
fundingAssetradom_common_rust.db.PayoutFundingAssetnullable
fundingWithdrawalIdsstring[]
fundingConversionIdsstring[]
fundingConversionErrorstringnullable
processingStagestringnullable
cryptoEntriesCryptoPayoutEntryResponse[]required
idstring<uuid>required
statusPayoutEntryStatusrequired
AllowedPendingProcessingCompleteInReviewFailed
amountnumber<float>required
customerIdstring<uuid>nullable
networkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat
tokenstringnullable
payoutAddressstringrequired
txHashstringnullable
externalAccountIdstring<uuid>nullable
fundingCurrencyPayoutFundingCurrencynullable
failureReasonstringnullable
hedgePayoutEntryHedgeResponsenullable
fundingCurrencyPayoutFundingCurrencyrequired
fundingNetworkNetworkrequired
AllowedBitcoinBitcoinTestnetLitecoinLitecoinTestnetDogecoinDogecoinTestnetBitcoinCashBitcoinCashTestnetBitcoinSVBitcoinSVTestnetHarryPotterObamaSonic10InuHarryPotterObamaSonic10InuTestnetCardanoDashSolanaSolanaTestnetSolanaDevnetEthereumSepoliaTestnetPolygonPolygonTestnetBNBBNBTestnetArbitrumArbitrumTestnetZcashZcashTestnetPolkadotPolkadotTestnetPolkadotAssetHubPolkadotAssetHubTestnetTronTronTestnetAvalancheAvalancheTestnetBaseBaseTestnetOptimismOptimismTestnetFiat
fundingTokenstringnullable
lockedRatenumber<float>required
midPricenumber<float>required
guaranteedAmountnumber<float>required
feeBuffernumber<float>required
providerWithdrawalFeenumber<float>required
totalCryptoToAcquirenumber<float>required
stableForTradenumber<float>required
conversionFeenumber<float>required
stablecoinCostnumber<float>required
swapIdstring<uuid>nullable
deliveryWithdrawalIdstring<uuid>nullable
fiatEntriesFiatPayoutEntryResponse[]required
idstring<uuid>required
statusPayoutEntryStatusrequired
AllowedPendingProcessingCompleteInReviewFailed
amountnumber<float>required
customerIdstring<uuid>nullable
currencyCurrencyrequired
AllowedUSDCADGBPEURAEDINRSEKBRLNZDAUDHKDNOKDKKJPYCNYCHFSGDPLNMXNCZKHUFZARSARRUBTRYILSUSDCUSDTEURCBTCTEST0ETHBNBSOLTRXAVAXMATIC
ibanstringnullable
sortCodestringnullable
bankCodestringnullable
bbanstringnullable
beneficiaryNamestringnullable
beneficiaryEmailstringrequired
beneficiaryCountrystringnullable
beneficiaryDobstringnullable
beneficiaryCompanyNamestringnullable
beneficiaryAddressLine1stringnullable
beneficiaryAddressLine2stringnullable
beneficiaryCitystringnullable
beneficiaryPostalCodestringnullable
beneficiaryStatestringnullable
externalAccountIdstring<uuid>nullable
failureReasonstringnullable
autoConfirmbooleanrequired

The merchant asked for the payout to go out (created with `autoConfirm`, or confirmed while a recipient was still being checked). While such a payout is still awaiting confirmation it is waiting on screening, not on the merchant.

createdAtstring<date-time>required
confirmedAtstring<date-time>nullable
completedAtstring<date-time>nullable
expiresAtstring<date-time>required
400Bad Request
errorstringrequired
401Unauthorized
errorstringrequired
500Internal server error
errorstringrequired