Learn about PayGlocal API Responses
The HTTP responses of the PayGlocal APIs have a common structure which will be discussed in this section. The structure and fields are illustrated and elaborated below.
API Response Structure
{
"gid": "",
"status": "",
"message": "",
"timestamp": "",
"reasonCode": "",
"data": {},
"errors": {}
}
| Response Field | Description |
|---|---|
| gid | PayGlocal ID to track each and every HTTP API request made in the system. |
| status | PayGlocal status of the API, whose value is a subset of the statuses found in this section. |
| message | PayGlocal message describing the response in a few words. |
| timestamp | Timestamp at which HTTP response is created indicating service completion. |
| reasonCode | PayGlocal Reason Code indicating the response status of the request from a PayGlocal perspective. The reason codes are listed below in this section. |
| data | If it is a successful response, some data points are returned which will differ from API to API. Check the API response section under API Reference for each API to understand what will be sent here. |
| errors | If it is a failure response, some error points are returned which will differ from error to error. |
PayGlocal Reason Codes
| Reason Code | Detailed Message |
|---|---|
| GL-201-000 | Declined by System |
| GL-201-001 | Transaction Created Successfully OR Sent for capture successfully OR Redirected to ACS form |
| GL-201-002 | Refund request sent successfully |
| GL-201-003 | Transaction partially approved |
| GL-201-004 | AVS Failed but issuer approved authorization |
| GL-201-005 | Processor Error |
| GL-201-006 | CVV Failed |
| GL-201-007 | Card expired. Request another card. |
| GL-201-008 | Insufficient funds |
| GL-201-009 | Lost or stolen card |
| GL-201-010 | Issuer down |
| GL-201-011 | Unauthorized card or payment on card not allowed by issuer |
| GL-201-012 | CVV mismatch |
| GL-201-013 | Payment exceeds limit on card |
| GL-201-014 | General Decline |
| GL-201-015 | Customer is blacklisted by issuer |
| GL-201-016 | Payment refused by the issuer |
| GL-201-017 | Payment refused by the issuer |
| GL-201-018 | Card account is found invalid |
| GL-201-019 | Authentication by customer failed |
| GL-201-020 | Merchant configuration is incorrect, contact PayGlocal customer support |
| GL-201-022 | Declined by Risk system |
| GL-201-023 | Payment authentication failure |
| GL-201-500 | Declined by System |
| GL-400-001 | Declined by System |
| GL-400-002 | Request contains invalid data |
| GL-400-003 | Request missing merchantTxnID |
| GL-400-004 | Card type not enabled for this MID |
| GL-400-006 | Amount mis-match with original transaction |
| GL-400-007 | Card type is not valid |
| GL-400-999 | Transaction not found |
| GL-501-000 | Declined by System |
| GL-501-001 | Declined by System |