When an API error occurs, an HTTP 4xx or HTTP 5xx status is returned with a code that provides more detailed information in the response.

List of possible Return Code IDs:

• 0: Undefined
• 1: Missing parameter
• 2: Validation failed
• 3: Merchant ID inexistent
• 4: Merchant inactive
• 5: Method is invalid
• 6: Hash check failed
• 7: IP check failed
• 8: Language is invalid
• 9: Method is unavailable
• 10: MethodOption is invalid
• 11: Action is invalid
• 12: Preapproval is invalid
• 13: Preapproved payment is invalid
• 14: Generic error
• 15: Unable to process the transaction
• 16: An error has occurred. Please try again later
• 17: Payment is invalid
• 18: Refund is invalid
• 19: Country is invalid
• 20: MerchantTransactionID is duplicated
• 100: Currency is invalid
• 101: Customer email is missing
• 102: Customer email is invalid
• 103: Merchant preapproval ID is missing
• 104: Merchant preapproval ID is invalid
• 105: Preapproval return URL is missing
• 106: Preapproval return URL is invalid
• 107: Preapproval description is missing
• 108: Preapproval description is invalid
• 109: Merchant preapproval ID is duplicated
• 110: Customer email is invalid for preapproval
• 111: Method ID is invalid for preapproval
• 112: Preapproval error
• 113: Preapproval action is invalid
• 114: Invalid preapproval details received
• 115: Preapproval ID is missing
• 116: Customer phone is missing
• 117: Customer phone is invalid
• 118: Amount invalid
• 119: Customer balance is insufficient
• 120: Country code is invalid
• 121: Unable to authorize transaction
• 122: Unable to cancel transaction
• 123: Invalid customer details
• 124: Invalid bank details
• 125: Bank is offline
• 126: Customer name is invalid
• 127: Site ID is missing
• 128: Article is missing
• 129: Article is invalid
• 130: Customer social security number is invalid
• 131: Customer gender is invalid
• 132: Customer shipping address is invalid
• 133: Customer billing address is invalid
• 134: Another refund is already in process
• 135: Site ID is invalid
• 136: Customer ID is invalid
• 137: Address ID is invalid
• 138: Card token is invalid
• 139: An error has occurred while processing the payment token
• 140: Invalid offset
• 141: Invalid limit
• 142: Invalid custom parameter
• 143: Missing parameter MethodID
• 144: Unable to process the preapproval
• 145: Unable to process the merchant site
• 146: Invalid merchant site
• 147: Address details are invalid
• 148: Unable to process the user
• 149: User details are invalid
• 150: DateTime is invalid
• 151: MerchantTransactionID is invalid
• 152: Refund type is invalid
• 153: Payment type is invalid
• 154: Preapproval state is invalid
• 155: Reference number is invalid
• 156: Reference number is duplicated
• 157: Unable to capture transaction
• 158: Missing parameter recurring period
• 159: Recurring period is invalid
• 160: Merchant site details are invalid
• 161: Invalid role ID
• 162: The shipping address of the customer does not match with the billing address
• 163: Unable to process the merchant site on SmartCards system
• 164: Customer date of birth is invalid
• 165: Customer first name is missing
• 166: Customer last name is missing
• 167: Billing address1 is missing
• 168: Billing address2 is missing
• 169: Billing zip code is missing
• 170: Billing city is missing
• 171: Billing city is invalid
• 172: Billing zip code is invalid
• 173: Billing country is missing
• 174: Company name is missing
• 175: Invalid article for country
• 180: SortBy is invalid
• 181: SortDirection is invalid
• 182: Invalid pageSize
• 183: Invalid pageIndex
• 184: PageIndex Out of Range
• 185: Invalid methodID
• 186: Invalid statusID
• 187: Customer name is missing
• 188: Customer CPF / CNPJ is missing
• 189: Customer CPF / CNPJ is invalid
• 190: Another recurring payment is already in process
• 191: MerchantSite inactive
• 192: MerchantSite Api Key does not match
• 193: Method is not assigned
• 194: Method option is not assigned
• 195: Method does not exist
• 196: Method option does not exist
• 197: Method disabled
• 198: Method option disabled
• 199: Method disabled for merchant
• 200: Method option disabled for merchant
• 201: Method option invalid for method
• 202: Abandoned transaction
• 203: Wrong technical configuration. Please contact support team.
• 204: Technical error. Please contact support team.
• 205: Technical error on method provider system
• 206: Customer identification required
• 207: Customer limit on operations exceeded
• 208: Customer account is temporarily blocked
• 209: Unable to determine mobile operator
• 210: Transaction already payed
• 211: User not registered
• 212: Description parameter is invalid
• 213: Underaged Customer
• 214: Incorrect Street Address
• 215: Transaction not authorized (Age/Account reasons)
• 216: Payment not found at provider
• 217: Transaction not completed
• 218: Purchase not approved due to credit reasons
• 219: Customer blocked for previous unpaid invoices
• 220: Customer Phone Region not allowed
• 221: R-Transaction : AC01 – Account Identifier incorrect (i.e. invalid IBAN of the Debtor).
• 222: R-Transaction : AC04 – Account closed.
• 223: R-Transaction : AC06 – Account blocked.
• 224: R-Transaction : AC13 – Debtor account is a consumer account.
• 225: R-Transaction : AG01 – Direct Debit forbidden on this account for regulatory reasons.
• 226: R-Transaction : AG02 – Operation code/transaction code/sequence type incorrect, invalid file format.
• 227: R-Transaction : AM04 – Insufficient funds.
• 228: R-Transaction : AM05 – Duplicate collection.
• 229: R-Transaction : BE05 – Identifier of the Creditor Incorrect.
• 230: R-Transaction : CNOR – Creditor Bank is not registered under this BIC in the CSM.
• 231: R-Transaction : DNOR – Debtor Bank is not registered under this BIC in the CSM.
• 232: R-Transaction : FF01 – File Format incomplete or invalid.
• 233: R-Transaction : MD01 – No mandate.
• 234: R-Transaction : MD02 – Mandate data missing or incorrect.
• 235: R-Transaction : MD06 – Disputed authorized transaction.
• 236: R-Transaction : MD07 – Debtor Deceased.
• 237: R-Transaction : MS02 – Refusal by the Debtor.
• 238: R-Transaction : MS03 – Reason not specified.
• 239: R-Transaction : RC01 – Bank Identifier (BIC) Incorrect.
• 240: R-Transaction : RR01 – Regulatory Reason.
• 241: R-Transaction : RR02 – Regulatory Reason.
• 242: R-Transaction : RR03 – Regulatory Reason.
• 243: R-Transaction : RR04 – Regulatory Reason.
• 244: R-Transaction : SL01 – Specific Service offered by the Debtor Bank.
• 245: Communication error with the Bank. Pease submit the request again.
• 246: Preapproval cancelled by consumer
• 247: Session timeout
• 248: Invalid creditor
• 249: Duplicate mandate reference
• 250: No documents to sign
• 251: Forbidden IBAN
• 252: Invalid account owner
• 253: Mandate signature failed
• 254: Invalid user approval (OTP) code
• 255: Inconsistent client data during signature. Please contact Support Team
• 256: Card operation refused by operator
• 257: Card operation bank refusal
• 258: Card operation access failure
• 259: Card operation invalid transaction reference
• 260: Card lost
• 261: Card stolen
• 262: Card suspect
• 263: Duplicate order
• 264: Resource not found
• 265: Incomplete request data
• 266: Invalid BIC
• 267: Invalid IBAN
• 268: Multiple requests to provider with the same mandate
• 269: Subscriber reached the monthly mandates limit with the same IBAN
• 270: Subscriber reached the limit of mandates created with the same phone number (3 uses per 6 months)
• 271: Mandate rejected due to risk controls (e-mail)
• 272: Allowed time for transaction has expired
• 273: Customer forced payment cancellation
• 274: BIC not reachable
• 275: User did not enter a PIN or TAN (timeout)
• 276: Connection timeout, bank unavailable. Please try again later
• 279: Payment amount is greater than allowed
• 280: Top-up of this user account is blocked
• 500: Internal error
• 6000: Custom reason