Body
Pause Mandate
The API can be used to Pause an Active Mandate
Note
Only ACTIVE mandates can be paused.
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/mandates/{mandate_id}
Production Link
POST
https://api.juspay.in/mandates/{mandate_id}
Authorization Header
Basic Auth
*
Base64 Encoded Username:Password
Mandatory
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:- Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
x-merchantid
*
string
Required
The Username that a merchant holds at Juspay.
Content-Type
string
application/x-www-form-urlencoded
x-routing-id
*
String
Required
We recommend passing the customer_id as the x-routing-id. If the customer is checking out as a guest, you can pass an alternative ID that helps track the payment session lifecycle. For example, this could be an Order ID or Cart ID.
Warning
This ID is associated with the customer. It plays a key role in ensuring consistency and maintaining connections across different systems. If you fail to pass the same x-routing-id for the same customer in all related API calls, it could lead to issues with API functionality. Therefore, it’s crucial that you use the same x-routing-id for all requests tied to the same customer.
Example:- customer_1122
Path Params
mandate_id
*
String
Mandatory
Mandate Id
Example:- 7KKTSsVLcQjskY5F4moS5M
Parameters
command
*
string
Required
To be set as "pause", to pause an existing active mandate.
pause_start_date
string
Date in UNIX EPOCH timestamp (UTC timezone) format, when the mandate will be paused. Default value can be the current date.
pause_end_date
string
Date in UNIX EPOCH timestamp (UTC timezone) format, when the mandate status will be automatically changed to ACTIVE. Default value can be set to mandate_end_date.
200 : Success
Response Body
start_date
string
Mandate start date in UNIX EPOCH timestamp (UTC timezone) format.
rule_type
string
Mandate execution rule type ie, ON | BEFORE | AFTER
revokable_by_customer
boolean
States if mandate is revokable by the customer
response_message
string
Represents the action performed. Ex: Pause mandate is scheduled, Mandate is Paused.
pause_start_date
string
Mandate pause start date in UNIX EPOCH timestamp (UTC timezone) format.
pause_end_date
string
Mandate pause end date in UNIX EPOCH timestamp (UTC timezone) format.
max_amount
integer
Max amount of mandate set while creating a mandate
mandate_type
string
Mandate type: MANDATE(Cards) or EMANDATE (others)
mandate_token
string
Unique Token provided by Juspay after mandate creation.
mandate_status
string
Status of the mandate. Will be PAUSED only if the mandate is at ACTIVE state earlier.
mandate_id
string
Unique Identifier for the mandate. Mandate id can be obtained from the List Mandate API response
last_activated_at
string
The time at which mandate moved to ACTIVE state.
frequency
string
Frequency of mandate set. By default ASPRESENTED
end_date
string
Mandate end date in UNIX EPOCH timestamp (UTC timezone) format.
block_fund
boolean
True/False based on the value passed during mandate creation
amount_rule
string
VARIABLE or FIXED
400 : Invalid Input data
Response Body
Mandate Not Found
JSON
status
String
error_message
String
error_code
String
Invalid Status Change Request
JSON
user_message
String
type
String
session_id
String
message
String
code
String
Invalid Pause Start Date
JSON
user_message
String
type
String
session_id
String
message
String
code
String
Invalid Pause End Date
JSON
user_message
String
type
String
session_id
String
message
String
code
String
Pause Start Date >= Pause End Date
JSON
user_message
String
type
String
session_id
String
message
String
code
String
401 : Authentication Failed
Response Body
status
string
error
error_code
string
access_denied
error_message
string
Invalid Authentication