Retrieve Payment Methods

Definition

https://sandbox.bluesnap.com/services/2/tools/payment-methods-info


With this request, you retrieve to retrieve the payment methods available to the shopper based on the following:

  • Shopper country
  • Shopper currency
  • Activated payment methods in the Merchant Portal

Request Content

Send a POST request to:

with the following properties:

PropertyTypeRequiredDescription
countrystringYesShopper's country
currencystringYesShopper's currency, using the supported currency codes

Errors

If the request fails, the API returns an HTTP 400 response, with the following information:

CodeNameError Description
22020NO_PAYMENT_METHODSThere are no payment methods available for this shopper.

Response Content

If successful, the response HTTP status code is 200 OK.
The response includes the supportedPaymentMethods or supported-payment-method object, with the following properties:

PropertyTypeDescription
paymentMethodCodeName
payment-method-code-name
StringPayment method short name, such as:
CC
WIRE
ECP
SEPA_DIRECT_DEBIT
BECS_DIRECT_DEBIT
ACSS_DIRECT_DEBIT
paymentMethodDisplayName
payment-method-display-name
StringPayment method full name, such as:
Credit Card
Wire Transfer
Electronic Check Presentment
SEPA Direct Debit
BECS Direct Debit Payments
Pre-Authorized Debit Payments
supportedTypes
supported-type
StringThis is only included if there is more than one type for a payment method. For example, Credit Card could include:
VISA
MASTERCARD
* AMEX

JSON

JSON Examples

Request Example

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/payment-methods-info \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \ 
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
{
   "country": "FR",
   "currency": "EUR"
}'

Response Example

{
    "country": "FR",
    "currency": "EUR",
    "supportedPaymentMethods": [
        {
            "paymentMethodCodeName": "WALLET_MP",
            "paymentMethodDisplayName": "Wallet MP"
        },
        {
            "paymentMethodCodeName": "CC",
            "paymentMethodDisplayName": "Credit Card",
            "supportedTypes": [
                "VISA",
                "MASTERCARD"
            ]
        },
        {
            "paymentMethodCodeName": "PAYPAL",
            "paymentMethodDisplayName": "PayPal"
        },
        {
            "paymentMethodCodeName": "WIRE",
            "paymentMethodDisplayName": "Wire Transfer"
        },
        {
            "paymentMethodCodeName": "MONEYBOOKERS",
            "paymentMethodDisplayName": "Moneybookers"
        },
        {
            "paymentMethodCodeName": "SEPA_DIRECT_DEBIT",
            "paymentMethodDisplayName": "SEPA Direct Debit"
        },
        {
            "paymentMethodCodeName": "BANKTRANSFER",
            "paymentMethodDisplayName": "Bank Transfer"
        },
        {
            "paymentMethodCodeName": "SOFORTUBERWEISUNG"
        }
    ]
}

Example Description

The example above shows a Retrieve Payment Methods request for a shopper in France with EUR as their currency, and a response showing the available payment types of:

  • Wallet: Wallet MP (Masterpass)
  • Credit card: Visa and Mastercard
  • Paypal
  • Wire Transfer
  • Money Bookers
  • SEPA Direct Debit
  • Bank Transfer
  • SOFORT

XML

XML Examples

Request Example

curl -v -X POST https://sandbox.bluesnap.com/services/2/tools/payment-methods-info \
-H 'Content-Type: application/xml' \
-H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
-d '
<?xml version="1.0" encoding="UTF-8"?>
<payment-methods-info xmlns="http://ws.plimus.com">
  <country>US</country>
  <currency>USD</currency>
</payment-methods-info>

Response Example

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<payment-methods-info xmlns="http://ws.plimus.com">
    <country>US</country>
    <currency>USD</currency>
    <supported-payment-method>
        <payment-method-code-name>WALLET_MP</payment-method-code-name>
        <payment-method-display-name>Wallet MP</payment-method-display-name>
    </supported-payment-method>
    <supported-payment-method>
        <payment-method-code-name>CC</payment-method-code-name>
        <payment-method-display-name>Credit Card</payment-method-display-name>
        <supported-type>VISA</supported-type>
        <supported-type>MASTERCARD</supported-type>
    </supported-payment-method>
    <supported-payment-method>
        <payment-method-code-name>PAYPAL</payment-method-code-name>
        <payment-method-display-name>PayPal</payment-method-display-name>
    </supported-payment-method>
    <supported-payment-method>
        <payment-method-code-name>WIRE</payment-method-code-name>
        <payment-method-display-name>Wire Transfer</payment-method-display-name>
    </supported-payment-method>
    <supported-payment-method>
        <payment-method-code-name>ECP</payment-method-code-name>
        <payment-method-display-name>Electronic Check Presentment</payment-method-display-name>
    </supported-payment-method>
    <supported-payment-method>
        <payment-method-code-name>MONEYBOOKERS</payment-method-code-name>
        <payment-method-display-name>Moneybookers</payment-method-display-name>
    </supported-payment-method>
    <supported-payment-method>
        <payment-method-code-name>BANKTRANSFER</payment-method-code-name>
        <payment-method-display-name>Bank Transfer</payment-method-display-name>
    </supported-payment-method>
</payment-methods-info>

Example Description

The example above shows a Retrieve Payment Methods request for a shopper in the US with USD as their currency, and a response showing the available payment types of:

  • Wallet: Wallet MP (Masterpass)
  • Credit card: Visa and Mastercard
  • Paypal
  • Wire Transfer
  • ECP
  • Money Bookers
  • Bank Transfer

Back to Top