Redirect to E-Wallet

Last changes: 12-16-2018

The payment process starts with the customer choosing to pay with an E-Wallet account on your checkout page.

Please ensure to format all numbers using the user’s browser locale. For example, a user with en-US will use a “dot” as the decimal separator, whereas de-DE shall be interpreted using a “comma” as the decimal separator.

The "E-Wallet"-button sends a POST request containing a hidden form content and navigates the customer’s browser away from the Merchant to the E-Wallet Portal, where the customer securely completes the payment. This is done without any prior user authentication with the E-Wallet, or API User authentication with the KontoCloud Web API.

To ensure high level of trustbetween the user and the chosen payment method, the user should see that they have been securely navigated away to the E-Wallet Portal. Therefore, framesets or iframes that obscure this redirection should not be used.

The hidden form content contains various payment information such as the “merchantAccno” and the “orderItems”. The example below shows the hidden form for a standard payment of one “Ladies T-Shirt” for 25.00 € and one “Ladies Pants” for 55.00 €.

Hidden Form Example

<!-- POST Form Data to {E-wallet portal base URL}/payment -->
<form action="https://{E-Wallet-Portal-Base-URL}/Payment" method="post">
    <input name="callBackUrl" value="http://example.com/Checkout/Confirmation" type="hidden">
    <input name="merchantTransactionId" value="CHECKOUT-Kl3n9Sdw54pf" type="hidden">
    <input name="paymentType" value="Standard" type="hidden">
    <input name="merchantAccno" value="MERCHANT-DE4321" type="hidden">
    <input name="currencyCode" value="EUR" type="hidden">
    <input name="orderItems[0].description" value="Ladies T-Shirt" type="hidden">
    <input name="orderItems[0].price" value="25,00" type="hidden">
    <input name="orderItems[0].count" value="1" type="hidden">
    <input name="orderItems[1].description" value="Ladies Pants" type="hidden">
    <input name="orderItems[1].price" value="55,00" type="hidden">
    <input name="orderItems[1].count" value="1" type="hidden">
    <div>
        <button>Pay With E-Wallet Account</button>
    </div>
</form>

The table below shows a detailed description of all possible parameters.

Parameter

Mandatory

Description

Data Type

Length

callbackUrl

yes

URL to the page were the User must be redirected after the Payment.

String

255

merchantTransactionId

yes

Identifier of the Payment inside the Merchant System.

String

64

paymentType

no

Type of the payment.

The following values are valid:

  • “Standard”
  • “BlockAmount”

If no value is posted, then “Standard” is used as the default one.

String

15

merchantAccno

yes

Merchant Account Number.

String

255

currencyCode

yes

Payment Currency Code.

String

3

orderItems:

    description

    price

    count

yes

yes

yes

yes

List of the Payment Order Description of the Position.

Price per a Position Item.

Count of Position Items.

Array:

String

Decimal

Numeric

 

255

18 | 2

5

emailAddress

no

Customer Email Address.

String

255

title

no

Customer Title.

String

2

firstName

no

Customer First Name.

String

100

lastName

no

Customer Last Name.

String

100

dob

no

Customer Date of Birth

YYYY-MM-DD

10

countryCode

no

Customer Country ISO2 or ISO3 Code.

String

3

street

no

Customer Street.

String

60

houseNumber

no

Customer House Number.

String

10

city

no

Customer Street.

String

50

state

no

Customer State.

String

50

postcode

no

Customer Postal Code.

String

10

mobilePhone

no

Customer Mobile Phone.

String

30