API Response

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