Payment Options

Last changes: 12-18-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.

Payment optionPayment option code

VISA

VISA

Mastercard

MSTRCRD

American Express

AMEX

Discover

DISCOVER

 

Payment optionPayment option code

VISA Debit

VISADBIT

VISA Electron

VISAELTRN

Maestro

MSTRO

Carte Bancaire

CRTBANCAIR

 

Payment optionPayment option code

Bank Account

BNKACCT

 

Payment optionPayment option code

PayPal

PAYPAL

 

Payment optionPayment option code

GiroPay

GIROPAY

SofortUeberweisung

SFRTUBWNG

iDEAL

IDEAL

PayU

PAYU

 

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

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 {Base URL}/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: H4sIAAAAAAA{partial omission for brevity}EAN2bJ/6l2XX+A5kJqdP+MwAA

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"
}

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

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 request the associated stored payment option reference as described in the section below.

3. Get Stored Payment Option Reference

The Technical Account solution allows you to store and manage multiple payment options for an account (see Payment Option Management). Use an API request as described in section Get Stored Payment Option to check if the previously selected payment option has already been stored.

If that's the case, use the associated payment option reference and proceed to the Authorization. Otherwise, the new payment option can be stored in accordance to the section Store New Payment Option.