Body
Wallet Payment
Create a payment transaction for paying from a prepaid Wallet. Once you have the response, depending on the “method” attribute, you will have to take the next step. If you receive GET, then take the value in the “URL” attribute and redirect the user to this location. If you receive POST, then “params” attribute will hold a map containing key-value pairs.
For Web, you can create a form with these parameters as hidden variables and auto submit the form. Example code in Javascript: Serialize Parameters
.
For Android, serialize this data such that it can be loaded to WebView directly via postData. Example code in Java: Serialize Parameters.
HANDLING POST
When you get POST as the authentication method in the response, then the customer must be redirected using a form. Example HTML code is given to you. Depending on your client language, choose the appropriate way to create the form.
HANDLING GET
When you get GET as the authentication method in the response, you may load the URL directly into the customer’s browser. You can easily achieve this by sending HTTP 302 from your server. However, if the API call was made from the browser, then you can utilize the code snippet provided.
Request
Response
API Endpoints
Sandbox Link
POST
https://api.sandbox.juspay.io/txns
Production Link
POST
https://api.juspay.io/txns
Authorization Header
Basic Auth
*
Base64 Encoded username:password
required
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
x-merchantid
*
string
required
Merchant ID provided by Juspay
Example:-
merchant-id
version
string
Pass the date in YYYY-MM-DD format
Example:-
2023-01-01
Content-Type
String
application/x-www-form-urlencoded
Parameters
Order object
*
string
Required
Order object pertaining to the order you are creating.
merchant_id
*
string
Required
ID of the merchant_account that you hold with us.
payment_method_type
*
string
Required
Must be WALLET
payment_method
*
string
Required
The actual payment method that was selected by the user. For WALLET transactions, the values will be shared by Juspay team.
redirect_after_payment
*
string
Required
This is a boolean variable and accepts true/false. We recommend that you set this to true. If set to true, then the user is redirected to the return\_url configured for the order. If set to false, then the user will be stopped at the response page from the gateway. Your client should be able to read the page/title to infer that the user has completed the transaction.
format
*
string
Required
If it is set to json, then the response will be HTTP 200 with a JSON formatted text. Otherwise, the response is HTTP 302 with the Location attribute having the destination URL.
200 : Success
Response Body
order_id
*
string
Required
order_id
txn_id
*
string
Required
txn_id
status
*
string
Required
Example : PENDING_VBV
payment
*
object
Required
authentication.method
*
string
Required
authentication.url
*
String
Required
authentication.params
Object
Only when you have POST as the authentication method
key1
String
key2
String
key3
String
400 : Invalid Input data
Response Body
status
string
error
error_message
string
Order timed out
error_code
string
invalid_request