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
- 279: Payment amount is greater 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
- 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
- 500: Internal error
- 6000: Custom reason