Basic HTTP Status Codes

We’ve build a REST API that uses conventional HTTP response codes to indicate success or failure of an API request. The basic HTTP status codes we use are:

  • 2xx: indicates a successful request
  • 4xx: you did something wrong
  • 5xx: we did something wrong
HTTP Status Code Summary
Code Meaning Description
200 OK The request was completed successfully.
201 Created The payment was correctly initialized.
204 No Content The request was received, but there is no need to send any data back.
400 Bad Request Often missing a required parameter.
401 Unauthorized No valid authorization header provided.
402 Request Failed The parameters were valid but the request failed.
404 Not Found The requested item doesn’t exist.
500, 502, 503, 504 Server errors We did something wrong.

GlobalPay Status Codes

List of transaction status IDs
Status ID Name Description Final Status Applicable for
1 Open The transaction is initiated in our system. No Payments / Refunds / Payouts
2 Success The transaction is successful. Yes Payments / Refunds / Payouts
3 Cancelled The payment was cancelled. The payments that can be cancelled are the payments with “Authorized” status or the payments that are cancelled by the customer on the form. Yes Payments
4 Failed The transaction has failed. Yes Payments / Refunds / Payouts
5 Expired The time period the customer had for completing the payment has expired. Yes Payments
9 Authorized The payment was successfully authorized. In the initial request the Capture parameter is sent to false so the responsibility of the capturing the payment is on the merchants side.
The goods can be delivered.
No Payments
13 CaptureRequested The payment was successfully authorized and the capture request was also sent to the provider.
The goods can be delivered.
No Payments
14 Exception The transaction needs manual review from Smart2Pay. No Payments
15 CancelRequested The cancel request has been sent. No Payments
16 Reversed The authorization has been reversed (the money were credited back to the customer account). Yes Payments
19 Disputed The payment is disputed by the customer. No Payments
26 Chargedback The cardholder has won the dispute and has received the money back. Yes Payments
35 PartiallyCaptured The payment is partially captured. Yes Payments

Card Processing Status Codes

List of transaction status IDs
Status ID Name Description Final Status Applicable for
1 Open The transaction is initiated in our system. No Payments / Refunds / Payouts
2 Success The transaction is successful. Yes Refunds / Payouts
3 Cancelled The payment was cancelled. The payments that can be cancelled are the payments with “Authorized” status or the payments that are cancelled by the customer on the form. Yes Payments
4 Failed The transaction has failed. Yes Payments / Refunds / Payouts
5 Expired The time period the customer had for completing the payment has expired. Yes Payments
7 PendingOnProvider The payment is awaiting approval from the downstream partners/acquirers. No Payments
9 Authorized The payment was successfully authorized. In the initial request the Capture parameter is sent to false so the responsibility of the capturing the payment is on the merchants side. The goods can be delivered. No Payments
11 Captured The transaction has been captured. Only payments with “Authorized” status can be captured. The goods can be delivered. Yes Payments
13 CaptureRequested The payment was successfully authorized and the capture request was also sent to the provider. In the initial request the capture parameter is sent to true so our service will handle the capturing of the payment automatically. The goods can be delivered. No Payments
14 Exception The transaction needs manual review from Smart2Pay. No Payments
15 CancelRequested The cancel request has been sent. No Payments
16 Reversed The authorization has been reversed (the money were credited back to the customer account). Yes Payments
19 Disputed The payment is disputed by the customer. No Payments
23 ChargebackWon The cardholder has lost the dispute and the money will return to the merchant. Yes Chargebacks
24 ChargebackLost The cardholder has won the dispute and has received the money back. Yes Chargebacks
26 Chargedback The cardholder has won the dispute and has received the money back. Yes Payments
27 SecondChargebackWon The cardholder has lost the second dispute and the money will return to the merchant. Yes Chargebacks
28 SecondChargebackLost The cardholder has won the second dispute and has received the money back. Yes Chargebacks
30 PendingChallengeConfirmation The fraud provider has challenged the payment. Payment is authorized. You can reject or accept the challenge. No Payments
33 QueuedForCapturing The payment will be sent automatically for capturing. No further action from you is required. The goods can be delivered. No Payments
34 QueuedForCanceling The payment will be sent automatically for canceling. No further action from you is required. No Payments
35 PartiallyCaptured The payment is partially captured. Yes Payments

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
  • 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