Skip to main content
POST
/
gl
/
v1
/
payments
/
initiate
PayDirect AUTO DEBIT standing instruction (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",
  "merchantCallbackURL": "https://api.prod.payglocal.in/gl/v1/payments/merchantCallback",
  "standingInstruction": {
    "data": {
      "amount": "15000",
      "numberOfPayments": "N",
      "frequency": "MONTHLY",
      "type": "FIXED",
      "startDate": "20260903"
    }
  },
  "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": "[email protected]",
      "callingCode": "+91",
      "phoneNumber": "9999999999"
    }
  }
}
'
{
  "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",
    "mandateId": "md_925996a0-9da6-42df-b968-8a14729885fd"
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://payglocal.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
AUTO DEBIT standing instructions

AUTO DEBIT standing instructions automatically process subsequent debits based on the configured schedule after successful mandate registration. Registration uses the same PayDirect initiate endpoint as GPI with a standingInstruction block.

​
Key points

  • Register the mandate using the Initiate API with startDate and a scheduled frequency such as WEEKLY, BIWEEKLY, MONTHLY, QUARTERLY, HALFYEARLY, or YEARLY (not ONDEMAND).
  • After successful registration, subsequent debit transactions are automatically initiated according to the configured schedule.
  • No SI sale API calls are required for subsequent debit transactions.
  • The amount for subsequent debits must be FIXED.
When Auto Debit is enabled for your MID, ONDEMAND frequency and VARIABLE type are not supported.

​
Supported payment methods

MethodDomesticInternational
Cards—✓
Standing instructions support international cards only. In Request body → paymentData, send cardData only (tokenData is not supported).

​
API

MethodPOST
Path/gl/v1/payments/initiate
Productionhttps://api.payglocal.in/gl/v1/payments/initiate
Sandboxhttps://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

Same as GPI. Set standingInstruction.data (amount, scheduled frequency, type: FIXED, startDate) in Request body below.

​
Next actions

PayGlocal debits on your configured schedule. Do not call SI subsequent payment for scheduled debits.
ActionAPI
Mandate statusCheck mandate status
Cancel mandateCancel standing instruction
Each scheduled debitGet transaction status and your merchantCallbackURL

Authorizations

​
x-gl-token-external
string
header
required

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

Scheduled auto debit standing instruction registration. International cards only (paymentData.cardData).

​
merchantTxnId
string
required

Merchant's unique transaction identifier. Alphanumeric only.

Required string length: 4 - 50
Example:

"23AEE8CB6B62EE2AF07"

​
merchantCallbackURL
string<uri>
required

Customers are redirected here post payment completion.

Example:

"https://api.prod.payglocal.in/gl/v1/payments/merchantCallback"

​
paymentData
object
required

International cards only. Send cardData only — tokenData is not supported for standing instruction registration.

​
standingInstruction
object
required
​
merchantUniqueId
string

Optional stable merchant-side ID for idempotency and reconciliation. Alphanumeric only.

Required string length: 15 - 40
Example:

"IFNN939494NJFJ"

​
riskData
object

Recommended for fraud checks and processor compliance.

Response

Returned immediately from initiate. Redirect the customer to data.redirectUrl, then poll data.statusUrl or Get Transaction Status. When mandate registration succeeds, data.mandateId may be present in data.

Response envelope for PayDirect standing instruction initiate (200). data may include mandateId. No fields in this envelope are marked required.

​
gid
string

PayGlocal transaction ID. Use for status, capture, and refund APIs.

Example:

"gl_o-a057c4d6b6c620741apzp0ZX2"

​
status
string

High-level status. Typically INPROGRESS immediately after initiate.

Example:

"INPROGRESS"

​
message
string

Human-readable status message.

Example:

"Transaction Created Successfully"

​
timestamp
string

Response timestamp (DD/MM/YYYY HH:MM:SS).

Example:

"02/06/2026 21:47:33"

​
reasonCode
string

Success code on initiate (e.g. 200). See 4xx responses for error codes.

Example:

"200"

​
data
object

Standing instruction registration may also return mandateId in data — store it for SI sale, status, and cancel.

​
errors
object

null on success.