Payment Methods
This API should be called while rendering the payment page. It provides a list of all the payment methods available for your account, allowing you to display the available payment options on the payment page.
If a static list of payment methods is maintained to display on the payment page, and those payment methods are not enabled on Juspay’s dashboard, the transaction will fail at Juspay’s end without being initiated to the underlying gateways or processors.
Unique identifier for the merchant. This is the Merchant ID provided by Juspay. The value is case sensitive.
Passing this value will help us route efficiently at network level.
Example:- x-merchantid: testaccount
Merchant Id for which you need to fetch the available payment methods
To get the payment methods that supports direct debit.
To get the payment methods supported for each gateway reference ID
To get outages on payment methods. Each payment method has a `juspay_bank_code`. By using `juspay_bank_code` as a lookup in the outage array, you can determine whether the payment method has outage or not.
NOTE: The outage basically functions based on a score at each payment method level. We maintain this score from for all Merchant- Payment method combinations. For each transaction created, we penalise this score by a small amount and if the transaction is successful (CHARGED or AUTHORIZED), then we add to this score so as to reward the Merchant <> Payment method.
We have 2 outage statuses: FLUCTUATE and DOWN and we assign these once the score falls below a certain threshold at our end. There is a soft reset from time to time to check the health where we allow a few transactions to go through, based on which we decide whether the Merchant <> Payment method combination is back UP (no outage being faced).
Apart from this, we reset the overall score at a pre-defined interval as well.
These thresholds can be customised based on merchant requirements.
Lists the available payment methods enabled for the merchant account on Juspay dashboard
Payment method Type
Example:- Sample Value: CARD, RTP,WALLET
Refers to payment method
Example:- Sample Value: VISA,APPLEPAY,PROMPTPAY
Specifies the Description of the payment method
Lists the available payment methods enabled for the merchant account along with wallet direct debit support
Payment method Type
Refers to payment method
Specifies the Description of the payment method
Specifies whether direct wallet support/ link and pay support is enabled for the specific payment method
Lists the available payment methods along with supported gateway_reference_ids
specifies the payment method available for the mentioned reference_id
Payment method Type
Refers to payment method
Specifies the Description of the payment method
Lists the payment methods experiencing outages
Denotes the outage status. Values can be DOWN/FLUCTUATE
Refers to payment method
Payment method Type
Specifies the Description of the payment method
Refers to payment method
Payment method Type
Specifies the Description of the payment method
Denotes the status
Example:- Sample value: true
Provides the reason for the error
Example:- Invalid Request
Error message can be displayed to the user
Example:- Invalid merchant id. Cannot process your request.
Additional info on the error message
category of the error
Example:- USER_ERROR
Error message can be displayed to the user
Example:- Please pass valid merchant_id in request.
Detailed info on the error
Example:- merchant_id is invalid.
Details on the missing field with which the error occurred
Have questions?
- Need help? Contact support
- LLM? Read llms.txt