GlobalPay Return Codes

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
  • 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)
  • 500: Internal error
  • 6000: Custom reason