Request to retrieve the payment options you can present to the payer, for example, the available payment methods and card types.
The returned options depend on your merchant profile configuration in the gateway and your input.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.
If you do not provide any input parameters, all values that could apply for all fields are returned: all of the possible card types, all of the possible currencies, and so on.
Depending on your configuration and the input parameters the response may also contain
Usage Note
You may not need to use this operation if your merchant profile configuration rarely changes and therefore the available payment options can be hard-coded into your website.
However, the operation will allow you to build the presentation and input validation for your checkout process in a dynamic way. As you are collecting more details from the payer during the checkout process, the operation tells you what fields to collect and what validation to apply.
If you have a simple configuration (for example, only accept a list of card types for s single currency), you can use the unmodified data set returned if the request is called without any input parameters for building the website's presentation and input validation.
If you have a more complex configuration (for example, accept USD and EUR currencies on Mastercard and Visa, but only USD on American Express), call the operation with parameters to restrict the returned values. For example:
Warning This operation must not be called directly from the browser, as it would expose your API integration password.
URL | https://na.gateway.mastercard.com/api/nvp/version/76 |
HTTP Method | POST |
Authentication |
This operation requires authentication via one of the following methods:
|