API Error codes

This article provides information about the error codes you may find when using the Payouts integration.
Error codeCategoryDescription
000Response codesInvalid Code.
200Response codesSuccess.
400Response codesBad Request.
401Response codesUnauthorized.
409Response codesConflict.
601PreviewInvalid Destination Country.
602PreviewInvalid Origin currency.
603PreviewInvalid amount.
604PreviewInvalid ISO code for destination currency.
605PreviewMerchant account not found.
606PreviewMerchant account not enabled.
607PreviewMerchant account has an invalid business model.
699PreviewGeneric error for Purchase Preview.
701Transactional errorsInsufficient balance.
702Transactional errorsDeclined by compliance.
703Transactional errorsGeneral Error Balance.
704Transactional errorsMinimum payout amount is invalid.
705Transactional errorsInvalid origin currency ISO code.
706Transactional errorsThe account was not found.
707Transactional errorsAccount not enabled.
708Transactional errorsInvalid business model.
709Transactional errorsGeneral error when obtaining business information.
710Transactional errorsBank entered not valid.
711Transactional errorsAccount entered not valid.
712Transactional errorsData request expired.
713Transactional errorsGeneral error when requesting data.
812API ValidationDeclined by validation for document.
813API ValidationDeclined by validation for account.
814API ValidationDeclined by validation for country.
816API ValidationReference ID already used.
This error is displayed in the Payouts console and is also returned via Webhook.
817API ValidationDestination currency Unsupported.
901RejectionsBank account is closed.
902RejectionsInvalid bank account.
903RejectionsInvalid bank account type.
904RejectionsInvalid bank branch.
905RejectionsMonthly limit exceeded for user.
906RejectionsRejected by merchant’s request.
907RejectionsThe bank account is unable to receive transfers.
908RejectionsInvalid beneficiary document.
909RejectionsBeneficiary name doesn’t match bank details.
910RejectionsPIX key invalid.
911RejectionsInvalid state change requested.
912RejectionsInsufficient Balance.
913RejectionsInvalid process date.
914RejectionsInsufficient Balance in integration.
915RejectionsGeneral error in integration.
916RejectionsBank reject.
921BR_InvalidWalletInvalid wallet
999RejectionsError.
footer
Last modified February 20, 2025

© Bamboo | All rights reserved 2025