Redirect-URL

A payment process needs a redirect-URL. If no redirect-URL is defined at all, the transaction will not be processed.

The merchant can send a redirect URL in case of a successful, a cancelled or a failed transaction. Depending on the result of the transaction the consumer will be redirected to the corresponding page of the merchant’s environment.

The redirect-URLs can be configured either on MAID level or they can be sent individually with each request.

When the merchant configures the redirect-URLs in the MAID, they don’t have to be present in the request. The redirect-URLs are automatically loaded from the MAID configuration. 

When the merchant determines the redirect-URLs in the request, the request’s redirect-URLs overwrite the MAID configuration for that particular transaction.

The merchant can determine up to three different redirect-URLs in one request. In that case the merchant can determine one success-URL, one for failure and one cancellation-URL.

Configured in MAID

In this request the redirect-URLs are configured on MAID level.

General Request Sample for Redirect-URL
<payment xmlns="http://www.elastic-payments.com/schema/payment">

    <merchant-account-id>9abf05c1-c266-46ae-8eac-7f87ca97af28</merchant-account-id>

    <request-id>bf5137a8-859c-465e-bcf9-31b6a0a6123a</request-id>

    <transaction-type>debit</transaction-type>

    <payment-methods>

        <payment-method name="*"/>

    </payment-methods>

    <requested-amount currency="EUR">1.00</requested-amount>

</payment>

* = The payment method can be any payment method that provides the redirect feature.

Determined in Request

In this request the redirect URL overwrites the redirect configuration in the MAID.

General Request Sample for Redirect URL
<payment xmlns="http://www.elastic-payments.com/schema/payment">

    <merchant-account-id>9abf05c1-c266-46ae-8eac-7f87ca97af28</merchant-account-id>

    <request-id>bf5137a8-859c-465e-bcf9-31b6a0a6123a</request-id>

    <transaction-type>debit</transaction-type>

    <payment-methods>

        <payment-method name="*"/>

    </payment-methods>

    <requested-amount currency="EUR">1.00</requested-amount>

    <fail-redirect-url>https://www.example.com/fail.html</fail-redirect-url>

    <cancel-redirect-url>https://www.example.com/cancel.html</cancel-redirect-url>

    <success-redirect-url>https://www.example.com/success.html</success-redirect-url>

</payment>

* = The payment method can be any payment method that provides the redirect feature.
Custom URL: