Sign in

v1

latestOpenAPI 3.0.32026-07-26206388.3 KB
Standing Instructions

SI Subsequent Payment

Triggers a subsequent debit for an on-demand (frequency: ONDEMAND) mandate only. Not used for auto debit — scheduled mandates are debited by PayGlocal. Register via PayDirect — SI on demand or PayCollect — SI on demand.

post/gl/v1/payments/si/sale

Request body

merchantTxnIdstring required

Merchant's unique transaction identifier. Required for /initiate and SI sale.

merchantUniqueIdstring

Merchant's secondary unique reference.

refundType'F' | 'P'

Full or partial refund indicator (used on refund calls).

refundActionstring

Refund lifecycle action.

captureType'F' | 'P'

Full or partial capture indicator (used on capture calls).

captureTxnboolean

If true on /initiate, the transaction is auto-captured post-auth.

merchantCallbackURLstring uri

URL PayGlocal redirects to after payment completion.

merchantCustomPayloadobject

Opaque merchant metadata echoed back in callbacks.

dcc_indicatorboolean

Set true to enable Dynamic Currency Conversion.

dccReferenceGidstring

PayGlocal DCC quote reference (when dcc_indicator=true).

Example request

{
  "merchantTxnId": "si_sub_1712345678",
  "standingInstruction": {
    "mandateId": "mandate_abc123",
    "data": {
      "type": "FIXED"
    }
  },
  "paymentData": {
    "totalAmount": "499.00",
    "txnCurrency": "INR"
  }
}

Response

Subsequent SI debit accepted.

gidstring

PayGlocal global transaction ID.

statusstring

High-level status of this API response.

messagestring

Human-readable message.

timestampstring

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

reasonCodestring

Empty on success; populated on failure.

dataobject

Operation-specific payload. Shape varies by endpoint.

errorsobject

Field-level validation errors (populated on 4xx).

Example response

{
  "gid": "gl_9c2645ed09edb22e",
  "status": "SUCCESS",
  "timestamp": "10/01/2026 15:00:00"
}