Standing Instruction Sale
SI Subsequent Payment
Initiate a subsequent recurring payment using an existing active mandate.
POST
/
gl
/
v1
/
payments
/
si
/
sale
SI Subsequent Payment
curl --request POST \
--url https://api.payglocal.in/gl/v1/payments/si/sale \
--header 'Content-Type: application/json' \
--header 'x-gl-token-external: <api-key>' \
--data '
{
"merchantTxnId": "si_sub_1712345678",
"standingInstruction": {
"mandateId": "mandate_abc123",
"data": {
"type": "FIXED"
}
},
"paymentData": {
"totalAmount": "499.00",
"txnCurrency": "INR"
}
}
'import requests
url = "https://api.payglocal.in/gl/v1/payments/si/sale"
payload = {
"merchantTxnId": "si_sub_1712345678",
"standingInstruction": {
"mandateId": "mandate_abc123",
"data": { "type": "FIXED" }
},
"paymentData": {
"totalAmount": "499.00",
"txnCurrency": "INR"
}
}
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/si/sale")
.header("x-gl-token-external", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantTxnId\": \"si_sub_1712345678\",\n \"standingInstruction\": {\n \"mandateId\": \"mandate_abc123\",\n \"data\": {\n \"type\": \"FIXED\"\n }\n },\n \"paymentData\": {\n \"totalAmount\": \"499.00\",\n \"txnCurrency\": \"INR\"\n }\n}")
.asString();const url = 'https://api.payglocal.in/gl/v1/payments/si/sale';
const options = {
method: 'POST',
headers: {'x-gl-token-external': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
merchantTxnId: 'si_sub_1712345678',
standingInstruction: {mandateId: 'mandate_abc123', data: {type: 'FIXED'}},
paymentData: {totalAmount: '499.00', txnCurrency: 'INR'}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": "gl_si_sub_abcdef",
"status": "INPROGRESS",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "",
"data": {
"gid": "gl_si_sub_abcdef",
"mandateId": "mandate_abc123",
"status": "INPROGRESS"
}
}{
"gid": "gl_9c2645ed09edb22e",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "VALIDATION_ERROR",
"data": {},
"errors": null,
"errorDetails": [
{
"fieldName": "paymentData.totalAmount",
"message": "This field is required"
}
]
}{
"gid": "gl_9c2645ed09edb22e",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "UNAUTHORIZED",
"data": {},
"errors": null,
"errorDetails": [
{
"fieldName": "authorization",
"message": "Invalid x-gl-token-external"
}
]
}When to Use
ONDEMAND mandates require this API for every subsequent debit. Register withfrequency: ONDEMAND on initiate — you then call SI sale whenever you want to charge (including weekly or monthly billing in your product; PayGlocal does not schedule ONDEMAND mandates).
AUTO DEBIT uses frequency values such as MONTHLY or WEEKLY on registration so PayGlocal runs the schedule — no SI sale API.
Use the mandateId from the original initiate response (it is not returned on later transactions). Applies to PayDirect and PayCollect on-demand mandates. See Standing Instruction Sale in the API Reference sidebar.
FIXED vs VARIABLE
type=FIXED— the debit amount is fixed to the amount supplied at mandate creation. Do not includepaymentData.totalAmount.type=VARIABLE— the debit amount is variable but must be ≤ themaxAmountset when the mandate was created.paymentData.totalAmountis required.
Common Failure Responses
{ "status": "REQUEST_ERROR", "message": "Mandate is not found | Mandate is inactive | Mandate is exhausted" }
If Auto Debit is enabled at the MID level, PayGlocal initiates subsequent payments automatically — this API is not applicable.
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.
Used by all
/gl/v1/payments/*endpoints.
Body
application/json
Unified request body for payment initiation, capture, refund, reversal, and SI operations.
Most fields are optional — which fields are required depends on the operation. See each
endpoint's required: list for operation-specific rules.
Note: required: lists are best-effort and derived from current integration examples —
validate against your integration spec or contact your PayGlocal implementation lead.
Response
Subsequent SI debit accepted.
Standard PayGlocal response envelope (GlocalApiResponse).
SI Subsequent Payment
curl --request POST \
--url https://api.payglocal.in/gl/v1/payments/si/sale \
--header 'Content-Type: application/json' \
--header 'x-gl-token-external: <api-key>' \
--data '
{
"merchantTxnId": "si_sub_1712345678",
"standingInstruction": {
"mandateId": "mandate_abc123",
"data": {
"type": "FIXED"
}
},
"paymentData": {
"totalAmount": "499.00",
"txnCurrency": "INR"
}
}
'import requests
url = "https://api.payglocal.in/gl/v1/payments/si/sale"
payload = {
"merchantTxnId": "si_sub_1712345678",
"standingInstruction": {
"mandateId": "mandate_abc123",
"data": { "type": "FIXED" }
},
"paymentData": {
"totalAmount": "499.00",
"txnCurrency": "INR"
}
}
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/si/sale")
.header("x-gl-token-external", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"merchantTxnId\": \"si_sub_1712345678\",\n \"standingInstruction\": {\n \"mandateId\": \"mandate_abc123\",\n \"data\": {\n \"type\": \"FIXED\"\n }\n },\n \"paymentData\": {\n \"totalAmount\": \"499.00\",\n \"txnCurrency\": \"INR\"\n }\n}")
.asString();const url = 'https://api.payglocal.in/gl/v1/payments/si/sale';
const options = {
method: 'POST',
headers: {'x-gl-token-external': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
merchantTxnId: 'si_sub_1712345678',
standingInstruction: {mandateId: 'mandate_abc123', data: {type: 'FIXED'}},
paymentData: {totalAmount: '499.00', txnCurrency: 'INR'}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": "gl_si_sub_abcdef",
"status": "INPROGRESS",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "",
"data": {
"gid": "gl_si_sub_abcdef",
"mandateId": "mandate_abc123",
"status": "INPROGRESS"
}
}{
"gid": "gl_9c2645ed09edb22e",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "VALIDATION_ERROR",
"data": {},
"errors": null,
"errorDetails": [
{
"fieldName": "paymentData.totalAmount",
"message": "This field is required"
}
]
}{
"gid": "gl_9c2645ed09edb22e",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "UNAUTHORIZED",
"data": {},
"errors": null,
"errorDetails": [
{
"fieldName": "authorization",
"message": "Invalid x-gl-token-external"
}
]
}
