Call status after every payment initiation, once the customer completes (or abandons) the flow. PayGlocal also sends lifecycle updates to your merchantCallbackURL, but status polling is the recommended way to confirm the final outcome and reconcile orders if a callback is delayed, retried, or missed.Use this endpoint for all GPI transactions — PayDirect and PayCollect, cards, UPI, net banking, Apple Pay, and global alternative payments.
Top-level status is the transaction state (e.g. SENT_FOR_CAPTURE, AUTHORIZED, INPROGRESS). The nested data.status often mirrors it for successful payments.
The data object varies by payment-method — use the Responses examples below (card, UPI, net banking, global alt pay, authorized card).
For auth-only flows (captureTxn: false), expect AUTHORIZED until you call capture.
Error Scenarios
Scenario
HTTP code
Unknown or invalid gid / merchantTxnId
404
Missing or invalid JWS
401
Authorizations
x-gl-token-external
string
header
required
RSA-signed JWS (JSON Web Signature) token carrying the request payload.
Payload: the exact JSON body sent in the request (or its SHA-256 digest when is-digested=true).
Signed with the merchant's RSA private key; PayGlocal verifies with the matching public key.
Used by all /gl/v1/payments/* endpoints.
Path Parameters
id
string
required
PayGlocal gid or merchantTxnId from the initiate request.
Response
Status retrieved successfully. Top-level status reflects the transaction state;
data includes method-specific fields keyed by payment-method.
Response envelope for GET /gl/v1/payments/{id}/status.
gid
string
PayGlocal transaction ID.
status
string
High-level transaction status (e.g. SENT_FOR_CAPTURE, AUTHORIZED, INPROGRESS).
message
string
Human-readable status message.
timestamp
string
Response timestamp (DD/MM/YYYY HH:MM:SS).
reasonCode
string
Reason code for this status (e.g. GL-201-001).
data
object
data payload for transaction status. Fields present depend on payment-method
(e.g. CARD, UPI_INTENT, INB, ZIP). See response examples on
Get Transaction Status.
Show child attributes
errors
object | null
null on success.
Get Transaction Status
curl --request GET \ --url https://api.payglocal.in/gl/v1/payments/{id}/status \ --header 'x-gl-token-external: <api-key>'