Standing Instruction Sale
Cancel Standing Instruction
Revoke an active mandate to prevent future recurring debits.
PUT
/
gl
/
v1
/
payments
/
si
/
status
SI Cancellation
curl --request PUT \
--url https://api.payglocal.in/gl/v1/payments/si/status \
--header 'Content-Type: application/json' \
--header 'x-gl-token-external: <api-key>' \
--data '
{
"mandateId": "mandate_abc123",
"action": "REVOKE"
}
'import requests
url = "https://api.payglocal.in/gl/v1/payments/si/status"
payload = {
"mandateId": "mandate_abc123",
"action": "REVOKE"
}
headers = {
"x-gl-token-external": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.put("https://api.payglocal.in/gl/v1/payments/si/status")
.header("x-gl-token-external", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"mandateId\": \"mandate_abc123\",\n \"action\": \"REVOKE\"\n}")
.asString();const url = 'https://api.payglocal.in/gl/v1/payments/si/status';
const options = {
method: 'PUT',
headers: {'x-gl-token-external': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({mandateId: 'mandate_abc123', action: 'REVOKE'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": "gl_si_revoke_001",
"status": "SUCCESS",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "",
"data": {
"mandateId": "mandate_abc123",
"mandateStatus": "REVOKED"
}
}{
"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
Revoke an active standing-instruction mandate. Future scheduled or on-demand debits will not be attempted. Once revoked, the mandate cannot be reactivated — register again via PayDirect or PayCollect initiate. See Standing Instruction Sale in the API Reference sidebar.Common Failure Responses
Already inactive:{ "status": "REQUEST_ERROR", "message": "Mandate was inactive" }
{ "status": "REQUEST_ERROR", "message": "Mandate id not found" }
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
Response
Mandate revoked.
Standard PayGlocal response envelope (GlocalApiResponse).
PayGlocal global transaction ID.
Example:
"gl_9c2645ed09edb22e"
High-level status of this API response.
Example:
"SUCCESS"
Human-readable message.
Response timestamp (DD/MM/YYYY HH:MM:SS).
Example:
"10/01/2026 15:00:00"
Empty on success; populated on failure.
Example:
""
Operation-specific payload. Shape varies by endpoint.
Field-level validation errors (populated on 4xx).
Show child attributes
Show child attributes
SI Cancellation
curl --request PUT \
--url https://api.payglocal.in/gl/v1/payments/si/status \
--header 'Content-Type: application/json' \
--header 'x-gl-token-external: <api-key>' \
--data '
{
"mandateId": "mandate_abc123",
"action": "REVOKE"
}
'import requests
url = "https://api.payglocal.in/gl/v1/payments/si/status"
payload = {
"mandateId": "mandate_abc123",
"action": "REVOKE"
}
headers = {
"x-gl-token-external": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)HttpResponse<String> response = Unirest.put("https://api.payglocal.in/gl/v1/payments/si/status")
.header("x-gl-token-external", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"mandateId\": \"mandate_abc123\",\n \"action\": \"REVOKE\"\n}")
.asString();const url = 'https://api.payglocal.in/gl/v1/payments/si/status';
const options = {
method: 'PUT',
headers: {'x-gl-token-external': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({mandateId: 'mandate_abc123', action: 'REVOKE'})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"gid": "gl_si_revoke_001",
"status": "SUCCESS",
"timestamp": "10/01/2026 15:00:00",
"reasonCode": "",
"data": {
"mandateId": "mandate_abc123",
"mandateStatus": "REVOKED"
}
}{
"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"
}
]
}