JavaScript is disabled. Some features may not work. You can also read the static version: View text version

Consumer Finance Payment

Create a transaction for paying from a consumer finance application.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.

Supported Payment Methods

Scroll inside to view more

Payment Method
ATOME PAYLATER
CAPITALFLOAT
EPAYLATER
GRABPAYPAYLATER
HDFC FLEXIPAY
ICICI PAYLATER
POSTPAY
SHOPSE
ZESTMONEY
PAYTM_POSTPAID

Request

Response

API Endpoints

Sandbox Link

POST

https://sandbox.juspay.in/txns

Production Link

POST

https://api.juspay.in/txns

                      Content-Type
                      *
                      

String

Mandatory

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.

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

Body

                      order_id
                      *
                      

string

Mandatory

Id pertaining to the order for which the payment is started.

                      merchant_id
                      *
                      

string

Mandatory

The username associated with Juspay

                      payment_method_type
                      *
                      

string

Mandatory

Must be CONSUMER_FINANCE

                      payment_method
                      *
                      

string

Mandatory

The actual payment method that was selected by the user from the table above.

                      redirect_after_payment
                      
                      

string

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

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.

                      offers
                      
                      

array of Strings

The key offers should be passed only when juspay offers are being used. The value for this key can set as the offerID which is received from /v1/offers/list api

Response Body

                      txn_uuid
                      
                      

string

eultUYSbJA5NEbJBD

                      txn_id
                      
                      

string

Test-Order1619519941-1

                      status
                      
                      

string

PENDING_VBV

                      payment
                      
                      

object

                      authentication.method
                      
                      

String

                      authentication.url
                      
                      

String

                      order_id
                      
                      

string

Order1619519941

Response Body

                      status
                      
                      

string

invalid_request_error

                      error_message
                      
                      

string

Payment method cannot be null

                      error_code
                      
                      

string

missing_payment_method