Return URLs

Smart Checkout can return the user to the merchants website. The URLs cover both, successful or failed payment.

One can define static URLs in SecuOffice, or pass dynamic URLs to the Smart Transaction. The dynamic URLs override the static ones.

Here is an example how to pass both individual return URLs:

Request Body
{
// ...
"application_context": {
"return_urls": {
"url_success": "https://shop.example.com/PAYMENT-SUCCEEDED",
"url_error": "https://shop.example.com/PAYMENT-FAILED",
"url_abort": "https://shop.example.com/PAYMENT-ABORTED"
}
},
// ...
}

Each return URL may have up to 2000 characters.

If there is a success URL, the user is offered a back-to-shop-link:

images/download/attachments/141539313/image2020-1-23_13-26-48-version-1-modificationdate-1706778763000-api-v2.png

The abort URL is used when the user aborts the checkout process.

images/download/attachments/141539313/image2020-1-23_13-34-54-version-1-modificationdate-1706778763000-api-v2.png

Please do not forget: It is cannot be guaranteed that the user really opens the URL.

If no abort URL is available the failure URL is used. If there is also no failure URL it is not offered to abort the process.

The failure URL is also used in the rare case of an unrecoverable error.