REDIRECT

The REDIRECT method is a browser-based flow where the consumer is redirected to a secure page to authenticate their payment. After completing the process, they are redirected back to the merchant’s website with the payment result.

REDIRECT authentication requires you to provide a returnUrl which is where the consumer will be returned after completing the payment.

Request

//...
  "authenticationSettings": [
    {
      "type": "REDIRECT",
      "settings": {
        "returnUrl": "https://example.com/order_details?order_id=12345"
      }
    }
  ]
//...

Response

//...
  "authenticationMethods": [
    {
      "details": {
        "requestUrl": "https://redirection-target.com",
        "requestMethod": "GET"
      },
      "type": "REDIRECT"
    }
  ]
//...

requestUrl is the URL where the consumer should be redirected to authenticate the payment.

requestMethod is GET or POST.

  • GET a simple redirection is expected.
  • POST a client-side form submission with requestUrl as the form target is expected.