Seamless Flow (PayDirect)
PayDirect Authorize Payment (Auth Only)
Authorize a PayDirect payment without capturing funds — hold funds with captureTxn false, then capture or reverse later.
POST
/
gl
/
v1
/
payments
/
initiate
PayDirect authorize payment — auth only (request body)
curl --request POST \
--url https://api.payglocal.in/gl/v1/payments/initiate \
--header 'Content-Type: application/json' \
--header 'x-gl-token-external: <api-key>' \
--data '
{
"merchantTxnId": "23AEE8CB6B62EE2AF07",
"merchantUniqueId": "IFNN939494NJFJ",
"captureTxn": false,
"paymentData": {
"totalAmount": "10.00",
"txnCurrency": "INR",
"cardData": {
"number": "4111111111111111",
"expiryMonth": "05",
"expiryYear": "2026",
"securityCode": "111"
},
"billingData": {
"firstName": "John",
"lastName": "Doe",
"addressStreet1": "221B Baker Street",
"addressCity": "Bengaluru",
"addressCountry": "IND",
"emailId": "john.doe@example.com",
"callingCode": "+91",
"phoneNumber": "9999999999"
}
},
"merchantCallbackURL": "https://api.prod.payglocal.in/gl/v1/payments/merchantCallback"
}
'import requests
url = "https://api.payglocal.in/gl/v1/payments/initiate"
payload = {
"merchantTxnId": "23AEE8CB6B62EE2AF07",
"merchantUniqueId": "IFNN939494NJFJ",
"captureTxn": False,
"paymentData": {
"totalAmount": "10.00",
"txnCurrency": "INR",
"cardData": {
"number": "4111111111111111",
"expiryMonth": "05",
"expiryYear": "2026",
"securityCode": "111"
},
"billingData": {
"firstName": "John",
"lastName": "Doe",
"addressStreet1": "221B Baker Street",
"addressCity": "Bengaluru",
"addressCountry": "IND",
"emailId": "john.doe@example.com",
"callingCode": "+91",
"phoneNumber": "9999999999"
}
},
"merchantCallbackURL": "https://api.prod.payglocal.in/gl/v1/payments/merchantCallback"
}
headers = {
"x-gl-token-external": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.post("https://api.payglocal.in/gl/v1/payments/initiate")
.header("x-gl-token-external", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantTxnId\": \"23AEE8CB6B62EE2AF07\",\n \"merchantUniqueId\": \"IFNN939494NJFJ\",\n \"captureTxn\": false,\n \"paymentData\": {\n \"totalAmount\": \"10.00\",\n \"txnCurrency\": \"INR\",\n \"cardData\": {\n \"number\": \"4111111111111111\",\n \"expiryMonth\": \"05\",\n \"expiryYear\": \"2026\",\n \"securityCode\": \"111\"\n },\n \"billingData\": {\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"addressStreet1\": \"221B Baker Street\",\n \"addressCity\": \"Bengaluru\",\n \"addressCountry\": \"IND\",\n \"emailId\": \"john.doe@example.com\",\n \"callingCode\": \"+91\",\n \"phoneNumber\": \"9999999999\"\n }\n },\n \"merchantCallbackURL\": \"https://api.prod.payglocal.in/gl/v1/payments/merchantCallback\"\n}")
.asString();const url = 'https://api.payglocal.in/gl/v1/payments/initiate';
const options = {
method: 'POST',
headers: {'x-gl-token-external': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
merchantTxnId: '23AEE8CB6B62EE2AF07',
merchantUniqueId: 'IFNN939494NJFJ',
captureTxn: false,
paymentData: {
totalAmount: '10.00',
txnCurrency: 'INR',
cardData: {
number: '4111111111111111',
expiryMonth: '05',
expiryYear: '2026',
securityCode: '111'
},
billingData: {
firstName: 'John',
lastName: 'Doe',
addressStreet1: '221B Baker Street',
addressCity: 'Bengaluru',
addressCountry: 'IND',
emailId: 'john.doe@example.com',
callingCode: '+91',
phoneNumber: '9999999999'
}
},
merchantCallbackURL: 'https://api.prod.payglocal.in/gl/v1/payments/merchantCallback'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": "gl_o-a057c4d6b6c620741apzp0ZX2",
"status": "INPROGRESS",
"message": "Transaction Created Successfully",
"timestamp": "02/06/2026 21:47:33",
"reasonCode": "200",
"data": {
"redirectUrl": "https://api.uat.payglocal.in/gl/payflow-ui/?x-gl-token=example",
"statusUrl": "https://api.uat.payglocal.in/gl/v1/payments/gl_o-a057c4d6b6c620741apzp0ZX2/status?x-gl-token=example",
"merchantTxnId": "23AEE8CB6B62EE2AF07"
},
"errors": null
}{
"gid": "gl_9c2645ed09edb22e",
"status": "REQUEST_ERROR",
"message": "Authentication failed, please contact support.",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "GL-400-001",
"data": {},
"errors": {
"detailedMessage": "Authentication failed, please contact support.",
"displayMessage": "Something went wrong. We'll take you back to checkout so that you can try again."
},
"errorDetails": {}
}{
"gid": "gl_9c2645ed09edb22e",
"status": "BLACKLIST_MATCH",
"message": "You are not allowed to onboard on this platform. Please contact support.",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "GL-403-001",
"data": {},
"errors": {
"detailedMessage": "You are not allowed to onboard on this platform, please contact support.",
"displayMessage": "Something went wrong. We'll take you back to checkout so that you can try again."
},
"errorDetails": {}
}{
"gid": "gl_9c2645ed09edb22e",
"status": "REQUEST_ERROR",
"message": "Authentication failed, please contact support.",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "GL-400-001",
"data": {},
"errors": {
"detailedMessage": "Authentication failed, please contact support.",
"displayMessage": "Something went wrong. We'll take you back to checkout so that you can try again."
},
"errorDetails": {}
}Authorize payment (auth only)
Authorize a PayDirect payment without capturing funds immediately. This flow places a hold on the customer’s funds so you can capture or reverse the authorization later. The same PayDirect initiate API as GPI is used for authorization. SetcaptureTxn to false in Request body.
When to Use
Use this flow when you need to verify and reserve funds before completing the transaction, such as:- Hotel and hospitality bookings
- Vehicle rentals
- Delayed order fulfillment
- Inventory confirmation workflows
- Any scenario requiring payment approval before final settlement
- Capture the authorized amount to complete the payment — standalone capture
- Reverse the authorization to release the held funds — auth reversal
Supported payment methods
Authorize (auth only) supports cards and international Apple Pay only. UPI and net banking are not available on PayDirect.| Method | Domestic | International |
|---|---|---|
| Cards | ✓ | ✓ |
| Apple Pay | — | ✓ |
API
| Method | POST |
| Path | /gl/v1/payments/initiate |
| Production | https://api.payglocal.in/gl/v1/payments/initiate |
| Sandbox | https://api.uat.payglocal.in/gl/v1/payments/initiate |
GPI, on-demand SI, auto-debit, and authorize all call this path. Only the JSON request body differs.
Headers
| Header | Mandatory | Description |
|---|---|---|
Content-Type | Yes | application/json |
x-gl-token-external | Yes | RSA-signed JWS of the request body (see Key Management) |
x-gl-merchantid | Yes | Your PayGlocal merchant ID (MID) |
x-gl-kid | Yes | Key ID of the private key used to sign the JWS |
captureTxn to false in Request body below, with cardData or tokenData as for GPI.
Only one successful capture is allowed per authorisation.
Next steps
| Action | API |
|---|---|
| Capture | POST /payments//capture |
| Reverse hold | POST /payments//auth-reversal |
| Status | Get transaction status — expect AUTHORIZED until capture |
| Refund | After SENT_FOR_CAPTURE — Refund |
Authorizations
RSA-signed JWS (JSON Web Signature) token carrying the request payload.
- Header:
{ "alg": "RS256", "kid": "<merchant-key-id>", "iss": "<merchant-id>", "x-gl-enc": "false", "is-digested": "true" } - 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.
Body
application/json
Auth-only initiate (captureTxn must be false). Cards and international Apple Pay only — UPI and net banking are not supported for auth.
Response
Returned immediately from initiate. Redirect the customer to data.redirectUrl, then poll data.statusUrl or Get Transaction Status. Expect AUTHORIZED until you capture. No mandateId in data.
Response envelope for PayDirect initiate (200). GPI and auth-only — data does not include mandateId.
No fields in this envelope are marked required.
PayDirect authorize payment — auth only (request body)
curl --request POST \
--url https://api.payglocal.in/gl/v1/payments/initiate \
--header 'Content-Type: application/json' \
--header 'x-gl-token-external: <api-key>' \
--data '
{
"merchantTxnId": "23AEE8CB6B62EE2AF07",
"merchantUniqueId": "IFNN939494NJFJ",
"captureTxn": false,
"paymentData": {
"totalAmount": "10.00",
"txnCurrency": "INR",
"cardData": {
"number": "4111111111111111",
"expiryMonth": "05",
"expiryYear": "2026",
"securityCode": "111"
},
"billingData": {
"firstName": "John",
"lastName": "Doe",
"addressStreet1": "221B Baker Street",
"addressCity": "Bengaluru",
"addressCountry": "IND",
"emailId": "john.doe@example.com",
"callingCode": "+91",
"phoneNumber": "9999999999"
}
},
"merchantCallbackURL": "https://api.prod.payglocal.in/gl/v1/payments/merchantCallback"
}
'import requests
url = "https://api.payglocal.in/gl/v1/payments/initiate"
payload = {
"merchantTxnId": "23AEE8CB6B62EE2AF07",
"merchantUniqueId": "IFNN939494NJFJ",
"captureTxn": False,
"paymentData": {
"totalAmount": "10.00",
"txnCurrency": "INR",
"cardData": {
"number": "4111111111111111",
"expiryMonth": "05",
"expiryYear": "2026",
"securityCode": "111"
},
"billingData": {
"firstName": "John",
"lastName": "Doe",
"addressStreet1": "221B Baker Street",
"addressCity": "Bengaluru",
"addressCountry": "IND",
"emailId": "john.doe@example.com",
"callingCode": "+91",
"phoneNumber": "9999999999"
}
},
"merchantCallbackURL": "https://api.prod.payglocal.in/gl/v1/payments/merchantCallback"
}
headers = {
"x-gl-token-external": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.post("https://api.payglocal.in/gl/v1/payments/initiate")
.header("x-gl-token-external", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantTxnId\": \"23AEE8CB6B62EE2AF07\",\n \"merchantUniqueId\": \"IFNN939494NJFJ\",\n \"captureTxn\": false,\n \"paymentData\": {\n \"totalAmount\": \"10.00\",\n \"txnCurrency\": \"INR\",\n \"cardData\": {\n \"number\": \"4111111111111111\",\n \"expiryMonth\": \"05\",\n \"expiryYear\": \"2026\",\n \"securityCode\": \"111\"\n },\n \"billingData\": {\n \"firstName\": \"John\",\n \"lastName\": \"Doe\",\n \"addressStreet1\": \"221B Baker Street\",\n \"addressCity\": \"Bengaluru\",\n \"addressCountry\": \"IND\",\n \"emailId\": \"john.doe@example.com\",\n \"callingCode\": \"+91\",\n \"phoneNumber\": \"9999999999\"\n }\n },\n \"merchantCallbackURL\": \"https://api.prod.payglocal.in/gl/v1/payments/merchantCallback\"\n}")
.asString();const url = 'https://api.payglocal.in/gl/v1/payments/initiate';
const options = {
method: 'POST',
headers: {'x-gl-token-external': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
merchantTxnId: '23AEE8CB6B62EE2AF07',
merchantUniqueId: 'IFNN939494NJFJ',
captureTxn: false,
paymentData: {
totalAmount: '10.00',
txnCurrency: 'INR',
cardData: {
number: '4111111111111111',
expiryMonth: '05',
expiryYear: '2026',
securityCode: '111'
},
billingData: {
firstName: 'John',
lastName: 'Doe',
addressStreet1: '221B Baker Street',
addressCity: 'Bengaluru',
addressCountry: 'IND',
emailId: 'john.doe@example.com',
callingCode: '+91',
phoneNumber: '9999999999'
}
},
merchantCallbackURL: 'https://api.prod.payglocal.in/gl/v1/payments/merchantCallback'
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": "gl_o-a057c4d6b6c620741apzp0ZX2",
"status": "INPROGRESS",
"message": "Transaction Created Successfully",
"timestamp": "02/06/2026 21:47:33",
"reasonCode": "200",
"data": {
"redirectUrl": "https://api.uat.payglocal.in/gl/payflow-ui/?x-gl-token=example",
"statusUrl": "https://api.uat.payglocal.in/gl/v1/payments/gl_o-a057c4d6b6c620741apzp0ZX2/status?x-gl-token=example",
"merchantTxnId": "23AEE8CB6B62EE2AF07"
},
"errors": null
}{
"gid": "gl_9c2645ed09edb22e",
"status": "REQUEST_ERROR",
"message": "Authentication failed, please contact support.",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "GL-400-001",
"data": {},
"errors": {
"detailedMessage": "Authentication failed, please contact support.",
"displayMessage": "Something went wrong. We'll take you back to checkout so that you can try again."
},
"errorDetails": {}
}{
"gid": "gl_9c2645ed09edb22e",
"status": "BLACKLIST_MATCH",
"message": "You are not allowed to onboard on this platform. Please contact support.",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "GL-403-001",
"data": {},
"errors": {
"detailedMessage": "You are not allowed to onboard on this platform, please contact support.",
"displayMessage": "Something went wrong. We'll take you back to checkout so that you can try again."
},
"errorDetails": {}
}{
"gid": "gl_9c2645ed09edb22e",
"status": "REQUEST_ERROR",
"message": "Authentication failed, please contact support.",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "GL-400-001",
"data": {},
"errors": {
"detailedMessage": "Authentication failed, please contact support.",
"displayMessage": "Something went wrong. We'll take you back to checkout so that you can try again."
},
"errorDetails": {}
}
