API Reference
GuidesAPI ReferenceGo to DashboardSite >
Start typing to search…

Error Codes

This comprehensive reference details all error codes returned by the Localpayment API across different transaction types. Understanding these codes is crucial for building robust error handling and providing clear user feedback.

Overview

Localpayment uses standardized error codes to communicate transaction outcomes and issues. Each error includes a code, status, and actionable guidance for resolution.

Standardized Format

Consistent error structure across all API endpoints

Actionable Guidance

Clear steps to resolve each type of error

Real-time Feedback

Immediate understanding of transaction status and issues

Payin

Payin transactions represent funds being deposited into a Localpayment account.

CodeStatusDescription
303RejectedInvalid exchange rate token
500RejectedExternal ID already used - Duplication
501RejectedCountry not found
502RejectedCurrency not allowed
503RejectedTransactions not found
504RejectedLimit exceeded
505RejectedInsufficient funds
506RejectedTransaction could not be cancelled
507RejectedTransaction could not be received
508RejectedInvalid merchant
509RejectedInvalid date
510RejectedTransaction could not be executed
511RejectedZeroAmount
512RejectedNotAllowedAmount
513RejectedInvalid Bank
514RejectedInvalid Service
537RejectedAccess Denied
538RejectedInvalid Password
539RejectedCommunication Error
600RejectedSender Blacklisted
601RejectedBeneficiary blacklisted
602RejectedAmount exceeds max limit
603RejectedRejected by AML
604RejectedRejected compliance limits
701RejectedIncorrectAccountNumber
702RejectedInactive Account
703RejectedInactive Transaction Account
707RejectedInvalidAccountCurrency
716RejectedTransactionNotSupported
719RejectedAmount must not be empty and more than 0
721RejectedNotAllowedCurrency
736RejectedInvalidCountry
771RejectedYour Client Payin Settings have not been configured
772RejectedYour Provider Payin Settings have not been configured
801RejectedParams error
802RejectedRejected by provider
803RejectedInvalid card cvv
804RejectedInvalid card number
805RejectedInvalid payment method code
806RejectedInvalid card cvv length
807RejectedInvalid card token provider
808RejectedGeneric provider error
809RejectedInvalid card number length
810RejectedNot allowed to process Credit or Debit Card of foreign countries - Only Local cards
811RejectedRequested amount is higher or lower than allowed max/min values
812RejectedExternal Id already used - duplication
813RejectedInvalid country
815RejectedInvalid email
817RejectedInvalid concept code
818RejectedInvalid payment method type
819RejectedInvalid payment method
820RejectedUnknown error
821RejectedInvalid card for payment method
822RejectedInvalid relationship between provider and payment method
823RejectedPayment method not supported by provider
824RejectedInvalid document
825RejectedSystem error to generate payin
826RejectedSystem error to cancel payin
827RejectedSystem error to refund payin
828RejectedSystem error to validate BIN
829RejectedSystem error to generate Installment Plan
830RejectedInstallments Plan token is invalid or expired
831RejectedFX Token not valid
832RejectedRejected by client
833RejectedSystem error to capture payin
835RejectedThe cardholder did not take a further authentication step
836Rejected3D Secure authentication time expired
850RejectedThis Source is not admitted
851RejectedError update subscription
900CancelledThe payin was cancelled
901ExpiredThe payin has expired
902RefundedThe payin was refunded
905CancelledThe authorization was cancelled
907ExpiredThe authorization was expired
908RejectedThe payer's account is unable to use this service
909RejectedThe user did not complete the checkout
910RejectedThe bank is currently unavailable for this payment method. Please consider using an alternative bank or try again later.
911RejectedThe Payer's bank account credentials are invalid, Please contact your bank or try again later
912RejectedAmount exceeds max limit for new contacts
913RejectedThe maximum number of transfers for new contacts was reached.
915RejectedThe phone number provided doesn't match any account
920RejectedThe payment method is currently not available for this country. Consider using another payment method or try again later.

Subscriptions

Subscription statuses relate to the overall state of a subscription, not individual payments. Individual payment attempts within a subscription are treated as Payin transactions (see above).

CodeStatusDescription
300RejectedInvalid param + [param name] + [reason]
301RejectedEmpty mandatory param + [param name]
834RejectedSystem error to generate subscription
851RejectedError update subscription
903CancelledThe subscription was canceled - merchant request
904CancelledThe subscription was canceled - too many failed attempts
921CancelledSubscription was canceled - due to lost chargeback

Payout

Payout transactions represent funds being withdrawn from a Localpayment account.

CodeStatusDescription
300RejectedInvalid param + [param name] + [reason]
301RejectedEmpty mandatory param + [param name]
302RejectedInvalid control string characters
303RejectedInvalid exchange rate token
400RejectedUnregistered IP address
401RejectedInvalid credentials
402RejectedUnauthorized
403RejectedFailure to connect to API
404RejectedToo many requests
500RejectedExternal ID already used - Duplication
501RejectedCountry not found
502RejectedCurrency not allowed
503RejectedTransactions not found
504RejectedLimit exceeded
505RejectedInsufficient funds
506RejectedTransaction could not be cancelled
507RejectedTransaction could not be received
508RejectedInvalid merchant
509RejectedInvalid date
510RejectedTransaction could not be executed
511RejectedZeroAmount
512RejectedNotAllowedAmount
513RejectedRestricted payment: Payment to a Virtual Account is not allowed
600RejectedSender Blacklisted
601RejectedBeneficiary blacklisted
602RejectedAmount exceeds max limit
603RejectedRejected by AML
604RejectedRejected compliance limits
701RejectedInvalidAccountNumber - Alias does not exist or could not be found
702RejectedInvalidAccountNumber - Account Closed
703RejectedInvalidAccountNumber - Account Blocked
704RejectedInvalidAccountType - Non-existent or invalid Account Type
705RejectedIncorrectAccountNumber - Doesn't match regex
707RejectedInvalidAccountCurrency
708RejectedInvalidAccountOwner - ID informed is not consistent with the Account Holder
709RejectedInvalidAccountOwner - ID informed is incorrect
710RejectedProcessingError
715RejectedInvalidAccountNumber - Alias does not exist or could not be found.
716RejectedTransactionNotSupported
719RejectedAmount must not be empty and more than 0
720RejectedBank Not Supported
721RejectedNotAllowedCurrency
736RejectedInvalidCountry
771RejectedInvalidPaymentTypeInformation
773RejectedThe bank does not work with this account type
801RejectedParams error
802RejectedRejected by provider
805RejectedInvalid payment method code
808RejectedGeneric provider error
809RejectedPayment not allowed to this beneficiary bank
810RejectedPayment amount exceeds the limit allowed for the beneficiary account.
811RejectedInvalid amount
812RejectedExternal Id already used - duplication
813RejectedInvalid country
815RejectedInvalid email
817RejectedInvalid concept code
818RejectedInvalid payment method type
819RejectedInvalid payment method
820RejectedUnknown error
821RejectedPIX not allowed to this beneficiary bank institution
822RejectedInvalid relationship between provider and payment method
823RejectedPayment method not supported by provider
824RejectedInvalid document
825RejectedSystem error to generate payout
826RejectedSystem error to cancel payout
827RejectedSystem error to refund payout
828RejectedSystem error to validate BIN
829RejectedPIX not allowed to this beneficiary bank account
830RejectedIncorrect data of the Bank
831RejectedError account not match beneficiary name
832RejectedError bank branch incorrect
833RejectedError account not accept transfers
834RejectedError beneficiary document does not match name
835RejectedThis Source is not admitted
836RejectedThis account does not match the beneficiary's identification document
900CancelledThe payout was cancelled
901ReturnedThe payout was returned
902RecalledThe payout was recalled
903RejectedInvalid QR code
904RejectedQR code has been cancelled
905RejectedQR code has expired
906RejectedQR code has already been paid
920RejectedThe payment method is currently not available for this country. Consider using another payment method or try again later.
921RejectedRechazado por cuenta fraudulenta

Currency Exchange

Currency Exchange transactions represent the conversion of funds from one currency to another.

CodeStatusCategoryDescription
303RejectedProcessingErrorThis exchange rate token has expired.
500RejectedProcessingErrorError master service
511RejectedBusinessLogicErrorZeroAmount
701RejectedProcessingErrorDebited Account Not Exists
702RejectedProcessingErrorAccounts owner client must be same
703RejectedProcessingErrorAccounts countries must be match
704RejectedProcessingErrorCredited account not exists
705RejectedProcessingErrorCredited account currency not match
706RejectedProcessingErrorTransaction type not allowed for credited account
707RejectedBusinessLogicErrorFields debited.amount and credited.amount are mutually exclusive. Only one of them must be reported
708RejectedBusinessLogicErrorAmount debit value must be reported
716RejectedProcessingErrorDebited account not admit transaction type
825RejectedProcessingErrorSystem error to generate currency exchange
826RejectedBusinessLogicErrorInvalid account balance amount
833RejectedBusinessLogicErrorCredited amount sent is different to amount calculated
890RejectedBusinessLogicErrorAfter hours transaction. Please try again at the time [timeRang]. Except on weekends and holidays.

Refund

Refunds represent the return of funds to a customer for a specific, previously completed Payin.

CodeStatusDescription
300RejectedInvalid param + [param name] + [reason]
301RejectedEmpty mandatory param + [param name]
302RejectedInvalid control string characters
303RejectedInvalid exchange rate token
400RejectedUnregistered IP address
401RejectedInvalid credentials
402RejectedUnauthorized
403RejectedFailure to connect to API
404RejectedToo many requests
500RejectedExternal ID already used - Duplication
501RejectedCountry not found
502RejectedCurrency not allowed
503RejectedTransactions not found
504RejectedLimit exceeded
505RejectedInsufficient funds
506RejectedTransaction could not be cancelled
507RejectedTransaction could not be received
508RejectedInvalid merchant
509RejectedInvalid date
510RejectedTransaction could not be executed
511RejectedZeroAmount
512RejectedNotAllowedAmount
600RejectedSender Blacklisted
601RejectedBeneficiary blacklisted
602RejectedAmount exceeds max limit
603RejectedRejected by AML
604RejectedRejected compliance limits
701RejectedIncorrectAccountNumber
702RejectedInvalidAccountNumber - Account Closed
703RejectedInvalidAccountNumber - Account Blocked
704RejectedInvalidAccountType - Non-existent or invalid Account Type
705RejectedIncorrectAccountNumber - Doesn't match regex
707RejectedInvalidAccountCurrency
708RejectedInvalidAccountOwner - ID informed is not consistent with the Account Holder
709RejectedInvalidAccountOwner - ID informed is incorrect
710RejectedInvalidAccountOwner - Not informed
716RejectedTransactionNotSupported
721RejectedNotAllowedCurrency
736RejectedInvalidCountry
771RejectedInvalidPaymentTypeInformation
801RejectedParams error
802RejectedRejected by provider
805RejectedInvalid payment method code
808RejectedGeneric provider error
809RejectedPayment not allowed to this beneficiary bank
810RejectedPayment amount exceeds the limit allowed for the beneficiary account.
811RejectedInvalid amount
812RejectedExternal Id already used - duplication
813RejectedInvalid country
815RejectedInvalid email
817RejectedInvalid concept code
818RejectedInvalid payment method type
819RejectedInvalid payment method
820RejectedUnknown error
821RejectedPIX not allowed to this beneficiary bank institution
822RejectedInvalid relationship between provider and payment method
823RejectedPayment method not supported by provider
824RejectedInvalid document
825RejectedSystem error to generate payout
826RejectedSystem error to cancel payout
827RejectedSystem error to refund payout
828RejectedSystem error to validate BIN
829RejectedPIX not allowed to this beneficiary bank account
831RejectedError account not match beneficiary name
832RejectedError bank branch incorrect
833RejectedError account not accept transfers
834RejectedError beneficiary document does not match name
900CancelledThe refund was cancelled
901ReturnedThe refund was returned
902RecalledThe refund was recalled

Wire In

Wire In transactions represent incoming wire transfers.

CodeStatusDescription
717RejectedByBankRejected

Wire Out

Wire Out transactions represent outgoing wire transfers.

CodeStatusDescription
404RejectedProvider Code not matching with account number
511RejectedZeroAmount
716RejectedRejected by admin
717RejectedByBankRejected by bank
718RejectedByBankDestination account not found
719RejectedByBankRejected
826RejectedInvalid account