Complete Order

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",
    "additionalInformation": {
        "internalTransactionsPendingSettlement": ["nRqm7Qid8HbFKESyTNLQg"],
        "requestId": "aff2728481a181dc36daedc14055b516"
    }
}

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

note

Payments with the payment type "BlockAmount" should only be considered as successfully authorized if the "statusCode" returned in 1.41 Get Payment Status is "AUTHORIZED" and the presentation amount equals the previously processed total amount.