Complete Order

Last changes: 04-28-2020

On completion of payment the customer will be redirected to the Merchant Website using POST request with the URL value defined in the “callBackUrl”with the following query string parameters.

Parameter name

Details

Set

paymentResult

On Success: “OK”

On Error: This value contains the error description.

Always

merchantTransactionId

As defined in the POST request in section Redirect to E-Wallet.

Always

unqiueReference

Unique transaction reference assigned by

KontoCloud.

If the payment has been successfully performed.

A successful payment will return a “uniqueReference” for the payment and the “paymentResult” of “OK”. If “paymentResult” is not set to “OK”, the response will contain an error.

To prevent misuse of the “callBackURL” on the client side, the payment should be confirmed by calling the API method 1.41 Get Payment Status using an authenticated API user, with a valid token. Tokens are issued using the API method 1.45 Issue Token, as described in the API Authentication section.

The API request must contain the “uniqueReference” (here TN3k4BRLQEdfPSxgf76DwJ) returned via the “callbackUrl”.

Get Payment Status Request

Path:

GET /payment/TN3k4BRLQEdfPSxgf76DwJ/status?partnerReference=DEV-SVR001-DE_CUSTID-KD97TH2FP6_CARTID-PYQRTGMCMQ_VGT284FYXV&localDate=2018-11-22&localTime=163835

Header:

Content-Type: application/json
Accept-Language: en-US
X-Auth-Token: H4sIAAAAAAA{partial omission for brevity}EAN2bJ/6l2XX+A5kJqdP+MwAA

Get Payment Status Response

Status Code:

200 (OK)

Header:

Content-Type: application/json
Accept-Language: en-US

{
    "uniqueReference": "TN3k4BRLQEdfPSxgf76DwJ",
    "partnerReference": "DEV-SVR001-DE_CUSTID-KD97TH2FP6_CARTID-PYQRTGMCMQ_VGT284FYXV",
    "initiatorAccno": "123456",
    "initiatorName": "Brandname Financial Services",
    "accno": "MERCHANT-DE4321",
    "presentationAmount": 80.00,
    "presentationCurrCode": "EUR",
    "presentationUsage": Purchase:1xLadies T-Shirt, 1xLadies Pants. Merchant:WidgetsGmbH.",
    "customerFullName": "Jacob Smith",
    "addr1": "Anystreet",
    "houseNumber": "321",
    "city": "Anycity",
    "state": "",
    "country": "Germany",
    "postCode": "12345",
    "statusCode": "CAPTURED",
    "statusReason": "",
    "localDate": "2018-11-22",
    "localTime": "163835",
    "sysDate": "2018-11-22",
    "sysTime": "143836",
    "responseCode": "0000",
    "responseDescription": "Successful execution"
}

The value “CAPTURED” for the parameter “statusCode” implies that the payment has been successfully processed (see Transaction Status).