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 does not exist
- 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: Customer did not complete the purchase
- 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 – CustomerIBAN – invalid
- 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
- 277: Merchant balance is insufficient
- 278: User does not exists
- 279: Amount is higher than allowed
- 280: Top-up of this user account is blocked
- 281: Insufficient Funds
- 282: Access not authorized
- 283: Expired split token
- 285: Amount is greater than available balance
- 286: Client’s QIWI Wallet account balance limit is exceeded
- 287: ExecutionDate is invalid
- 288: Amount is lower than allowed
- 289: Payment.SplitsAmount sum does not match Payment.Amount
- 290: Split.SiteID is invalid
- 291: Split.SiteID is inactive
- 292: Split.MerchantTransactionID is invalid
- 293: Split.MerchantTransactionID is duplicate
- 294: Split.Amount is invalid
- 295: Payment.SiteID does not allow splits
- 296: Split.SiteID does not belong to merchant
- 297: Split.ID is invalid
- 298: Split is invalid
- 299: Split.State is invalid
- 300: IBAN is missing
- 302: Crypto address is missing
- 303: Crypto address is invalid
- 304: Crypto currency is missing
- 305: Crypto currency is invalid
- 306: Invalid Service Gateway or Data Gateway were received from provider
- 307: Transaction already paid
- 308: Your month limit has been reached. Request a limit increase.
- 309: Your daily limit was reached. Request a limit increase.
- 310: Credit Carn Number is invalid
- 311: Security code invalid
- 312: Security question is missing
- 313: Security question is invalid
- 314: Security answer is missing
- 315: Security answer is invalid
- 316: IP address is missing
- 317: IP address is invalid
- 318: Suspicious or fraudulent transaction
- 319: Maximum bank account verification attempts reached
- 320: Account blocked or invalid
- 321: Transaction cancelled by Customer
- 322: Money not received
- 323: Refused by payor/payee
- 324: Risk management error
- 325: User failed to accept the payout transaction
- 326: Invalid/Expired token
- 327: Invalid merchant account
- 328: CustomerAccountNumber is invalid
- 329: BankAccountNumber is invalid
- 330: CustomerAccountNumber is missing
- 331: BankAccountNumber is missing
- 332: Cancelled by User
- 333: CustomerBIC is invalid
- 334: Credentials are required to access this resource
- 335: SortCode is invalid
- 336: SortCode is missing
- 337: Declined or returned by provider
- 338: Transfer not allowed
- 339: IBAN or Account is missing
- 340: AlipayPlus – invalid credentials
- 341: Transaction accepted, customer paid less than initiated
- 342: Transaction rejected, customer paid less than initiated
- 343: Transaction accepted, customer paid more than initiated
- 344: Transaction rejected, customer paid more than initiated
- 345: Withdrawal not completed. Please try again
- 346: Payout Billing address is missing
- 347: Payout fails at provider’s side.
- 348: Transaction Amount not within Merchant Limits
- 357: Payout fails at provider’s side.
- 358: Invalid Branch Code
- 359: Account Number required is IBAN is not provided
- 360: Account Country required if IBAN is not provided
- 361: Unable to cancel mandate
- 362: Mandate cannot be activated
- 363: Reason parameter is invalid
- 364: Debtor Bank BIC or Debtor Details are required as Debtor Bank is located in a NON-EEA Country
- 365: Bank Branch has closed (or is due to close
- 366: BACS transactions are not supported
- 367: Invalid Mandate Status
- 368: Mandate Type is invalid
- 369: Mandate is invalid
- 370: Duplicate Beneficiary Account Details Provided
- 371: Customer personal information mismatch
- 372: BIZUM has returned a KO
- 373: Processor refused the operation
- 374: Invalid beneficiarry details
- 375: Unable to refund
- 376: Unable to acquire
- 377: Transaction already rejected
- 378: Invalid/missing URL
- 379: Invalid/Missing card details
- 380: Invalid/Missing expiry date
- 381: Card expired
- 382: Invalid/Missing CVV
- 383: Invalid Card Holder
- 384: Transaction Declined; customer paid less than initiated; crypto refund pending
- 385: Transaction accepted; customer paid more than initiated; pending refund for Overpaid Crypto Amount
- 500: Internal error
- 6000: Custom reason