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

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
26 Chargedback The cardholder has won the dispute and has received the money back. Yes Payments
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