Redirect-Mode

---end

Form inputs are sent directly to the client API when working in redirect mode. The client API processes the request and forwards the user to a specific page of the online shop, depending on the result. The client API itself does not produce any output.

Redirect URLs

---end

Success URL The customer is forwarded to this URL if the query was successful. (e.g. if the payment was successful or if the address check was positive)
Error URL The customer is forwarded to this URL if the query was not successful. (e.g. if the payment was denied or if the address check was negative)

---end

Response data are attached to the URL as GET parameters and can be processed by you.

The end customer is directly forwarded to the "redirecturl" if provided in the PAYONE Platform response. After that, the end customer is send back to your success URL or error URL.

Remark

Payment data should not come into touch with your system. This is very important with credit card data. Certification according to the PCI standard is not necessary only if the card data does not come into touch with your systems. Sensible payment data should be sent directly from the form to the client API and should not be forwarded trough your systems (see below). Any other data can be queried in preceding steps.

---end

Important note

This mode is also known as “direct post”. The input fields are placed on the merchant payment page and not provided by PAYONE. Therefore the merchant needs to comply with PCI DSS SAQ A-EP certification. To be SAQ A compliant PAYONE recommends implementation of the PAYONE hosted-iFrame-solution. 

---end

HTML example
<form action="https://secure.pay1.de/client-api/" method="POST">

<input type="hidden" name="portalid" value="2000000">

<input type="hidden" name="aid" value="10000">

<input type="hidden" name="mode" value="test">

<input type="hidden" name="request" value="bankaccountcheck">

<input type="hidden"

  name="successurl" value="http://www.yoursite.com/success.php">

<input type="hidden"

  name="errorurl" value="http://www.yoursite.com/error.php">

<input type="hidden" name="hash" value="70eaec2a33fa1b4674c0b1ge5e982966">

<input type="hidden" name="responsetype" value="REDIRECT">

<input type="hidden" name="language" value="en">

<input type="hidden" name="bankcountry" value="DE">

<table>

<tr>

  <td>Account number</td>

  <td><input type="text" name="bankaccount"></td>

</tr>

<tr>

  <td>Sort code</td>

  <td><input type="text" name="bankcode"></td>

</tr>

</table>

<input type="submit" value="Buy now!">

</form>

---end

Redirect example
http://www.yoursite.com/error.php?status=ERROR&errocode=1083&errormessage= Parameter+%7Bbankaccount%7D+incorrect+or+missing&customermessage= Invalid+account+number.+Please+check+the+information+on+the+card.

---end