Payment Options

Last changes: 12-17-2018

In the first step of the payment process, the customer can choose from a variety of payment options.

The table below lists payment options and the corresponding Payment Option Code used in API methods and the SDKs. Contact Customer Support or your administrator to check the individual payment option codes enabled for your individual integration use case.

Credit card

Payment option	Payment option code
VISA	VISA
Mastercard	MSTRCRD
American Express	AMEX
Discover	DISCOVER

Debit card

Payment option	Payment option code
VISA Debit	VISADBIT
VISA Electron	VISAELTRN
Maestro	MSTRO
Carte Bancaire	CRTBANCAIR

SEPA

Payment option	Payment option code
Bank Account	BNKACCT

E-Wallets

Payment option	Payment option code
PayPal	PAYPAL

Real time bank transfer

Payment option	Payment option code
GiroPay	GIROPAY
SofortUeberweisung	SFRTUBWNG
iDEAL	IDEAL
PayU Pay-by-Link	PAYU
PayU Installments	PAYUINST
TWISTO Pay Later	PAYUTWST
BLIK	PAYUBLK

You can obtain all payment options associated with the Merchant Account in your Digital Marketplace by calling the applicable API method as described in section 1. Get Payment Options .

Hence, the process of selecting of a payment option is divided in the following steps.

1. Get Payment Options

This step is not mandatory. Although it allows for a more dynamic approach, the selectable payment options can be hardcoded as well.

The API request 1.21 Get Payment Options provides the list of payment options associated with an account.

Send the Account Number (here MERCHANT-DE4321), Account Number Type, a locale time stamp and several other parameters via a server-side call to our API. You find the complete API Reference here.

Get Payment Options Request

Path:: GET {baseURL}/account/MERCHANT-DE4321/paymentOptions?programCode=COMPANYDE&accnoType=00&partnerReference= DEV-SVR001-DE_CUSTID-QYX8MMMK9Y_CARTID-2VFKHW9YD6_TKDYKY8W9M&transactionTypeCode=INITAUTH&localDate=2018-10-15&localTime=155027
Header:: Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: eyJhbGciOiJSUzI1NiI{abbreviated}RW5kVG9rZW4=

The API response includes all available payment options associated with the account.

Get Payment Options Response

Status Code:: 200 (OK)
Header:: Content-Type: application/json
Accept-Language: en-US

{
    "accno": "MERCHANT-DE4321",
    "transactionTypeCode": "INITAUTH",
    "paymentOptions": [
        {
            "name": "VISA",
            "code": "VISA",
            "paymentGroup": "Cards",
            "paymentGroupCode": "CARDS",
            "paymentSubGroup": "Credit Cards",
            "paymentSubGroupCode": "CRDTCRD",
            "isStorable": true,
            "iconUrl": "https://.../visa.png"
        },
{
            "name": "Bank Account",
            "code": "BNKACCT",
            "paymentGroup": "Banks",
            "paymentGroupCode": "BANKS",
            "paymentSubGroup": "SEPA",
            "paymentSubGroupCode": "SEPA",
            "isStorable": true,
            "iconUrl": "https://.../sepa.png"
        }
    ],
    "programCode": "COMPANYDE",
    "partnerReference": "TEST-29RP2W9D64",
    "localDate": "2018-10-15",
    "localTime": "155027",
    "sysDate": "2018-10-15",
    "sysTime": "155036",
    "responseCode": "0000",
    "responseDescription": "Successful execution",
    "additionalInformation": {
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

In the interest of legibility we omitted parts of the “iconURL”.

The return parameter "isStorable" indicates whether the payment option can be stored and used for recurring payments. Payment options cannot be stored in the case of Guest Payments. However, Technical Accounts and E-Wallets facilitate, among other features, the storage of payment options.

2. Customer Selects a Payment Option

Redirect the shopper from the Checkout to your webpage displaying either the hardcoded or previously requested payment options. After the customer selected a payment option, you can initialize the authorization of the payment.

Previous

Next