Mandate Registration API

Use this API to choose the preferred mode of payment for the mandate. Supported Payment Methods include UPI, Card, Wallet, eNACH with Card/NB/Aadhaar authentication and eMandate (Direct Bank NB Mandate). The same API will also validate the payment method specific data like UPI VPA etc.

Share the URL that you get in the response body with your end customer, for whom this mandate is being initiated. They will have to run the same to authorise the collect request from their UPI App.
The API is not required for the merchants using Juspay's Payment Page product.

Response Parameters:

In the redirect response, webhook and check status API, mandate data will be passed additionally from the current parameters.

ParameterTypeConstraintsDescription
order_idStringUnique Identifier for the order.
txn_idStringTransaction ID for the payment attempt.
statusStringStatus of the transaction. PENDING_VBV indicates that the transaction requires authentication to complete.
payment.authentication.methodStringHTTP Method for authentication. Can be one of GET or POST
payment.authentication.urlStringURL to which the user has to be taken to for completing the authentication
payment.authentication.paramsStringPresent only when the method is POST. Parameter map that has to be sent along with the URL for authentication. Do not hardcode the params in your client * Never assume that you will receive param “x” or param “y”. This is completely dynamic and will vary on a case by case basis.

Test Cards

Please use the below test cards for testing mandates

Billdesk:
VISA
Card Number: 4591500000000055,
Expiry Month: 12,
Expiry Year: 2029,
Name on Card: Test,
CVV: 123

OTP is 123456

Note: For this card, Transaction status will be successful
and Mandate status will be active

MASTERCARD
Card Number: 5252521111111117,
Expiry Month: 12,
Expiry Year: 2029,
Name on Card: Test,
CVV: 123

OTP is 123456

Note: For this card, Transaction status will be successful
and Mandate status will be failure

RAZORPAY

Card Number: 4022757915248950,
Expiry Month: 01,
Expiry Year: 2022,
Name on Card: Test,
CVV: 123

PAYU

Card Number: 5123456789012346,
Expiry Month: 01,
Expiry Year: 2024,
Name on Card: Test,
CVV: 123
OTP: 123456

VPA: 9999999999@upi

PG's and Supported Payment Methods

Language
Authorization
Basic
base64
:
Click Try It! to start a request and see the response here!