Body
Txns API
Once the order creation is completed and the user is redirected to the payment page and selects CRED Pay for the payment, the /txns api is to be called. The curl is given below for the reference.
Error
Collect Request will be triggered to
sdk_pg_params.phoneNumberKindly pass phoneNumber encrypted using RSA PKCS1 method with public key
of juspay and append “enc-” as prefix.
Note
When the credAppPresent is true then the merchant needs to fire the intent_url provided in the response, Merchant can write a custom logic like when checkout_mode is intent then fire intent url else load juspay’s authentication.url.
Please refer to the set up page for more details.
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/txns
Production Link
POST
https://api.juspay.in/txns
Headers
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.
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
Request Schema: application/json
Basic Parameters
order_id
*
String
Mandatory
Merchant should pass the order_id
merchant_id
*
String
Mandatory
Merchant should pass the merchant_id
payment_method_type
*
String
Mandatory
Should be passed as “WALLET”
payment_method
*
String
Mandatory
Should be passed as “CRED”
redirect_after_payment
*
String
Mandatory
Should be passed as true(boolean)
format
*
String
Mandatory
Should be passed as json
sdk_params
*
String
Mandatory
Should be passed as true(boolean)
sdk_pg_params.platform
*
String
Mandatory
Possible values: android, web
sdk_pg_params.os
*
String
Mandatory
Possible values: android, iOS, windows, linux, macOS, unknown
Please contact juspay team if you are facing any concern around it
sdk_pg_params.device
*
String
Mandatory
Possible values: mobile, iPAD, desktop, tablet, unknown
Please contact juspay team if you are facing any concern around it
sdk_pg_params.countryCode
*
String
Mandatory
Exact country code to be passed, For indian number, please pass “+91”
sdk_pg_params.phoneNumber
*
String
Mandatory
Must be encrypted using juspay public key with RSA PKCS1 Encryption
Required to trigger a collect request when the flow is collect and auto-fill the number in CRED redirect page when the flow is REDIRECT
sdk_pg_params.credAppPresent
*
String
Mandatory
Merchant need to pass it as true/false(boolean) basis on cred app present
sdk_pg_params.metadata
String
It is a json object, Merchant can use it to send extra data to CRED
200 : Success
Response Body
txn_uuid
String
txn_id
String
status
String
payment
object
sdk_params
Object
status
String
error_code
String
response
object
checkout_mode
String
state
String
layout
object
icon
String
banner_text
String
sub_text
String
cta_text
String
title
String
tracking_id
String
intent_url
String
reference_id
String
error_description
String
error_message
String
authentication
object
url
String
method
String
order_id
String
Have questions?
- Need help? Contact support
- LLM? Read llms.txt