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