Payment Options Inquiries
Mastercard Gateway contains a Payment Options Inquiry API operation that allows you to obtain information about various payment options that have been configured for your merchant account. You can offer the available options to your payers when they are making a payment for an order.
Supported integration and payment methods
| Integration methods | Payment methods |
|---|---|
|
All |
The options returned by the inquiry depend on your merchant profile configuration in the gateway and the content of your request. For example, when you provide the order currency in the request, the response only contains payment options that are available for orders with this currency. For details on the fields to be used in the API request, see Payment Options Inquiry.
Types of inquiries
You can make the following kinds of inquiries or combinations of them:
- List of available payment methods
You can determine, for example, whether your payer is allowed to use a credit card or PayPal for their payment.
- List of supported card types
You can determine which card schemes you can allow your payer to use.
- Card-related details
You can use the payer's card number prefix to retrieve details about the card scheme, brand, and funding method, to assist you in any surcharging decisions.
- List of allowed transaction sources
You can determine the channels through which you are allowed to gather the payer's authorization for the order.
- Currency-related details
You can determine the currencies you can support. In addition, if the payer wants to use a different currency in their order, you can retrieve a Dynamic Currency Conversion (DCC) quote to give the payer the exact amount information in the currency they prefer.
- List of valid payment plans for a transaction
If you want to give the payer the option of paying in installments, you can retrieve available payment plans. Use the data to show the payer the details of the possible plans they can choose from.