Skip to end of metadata
Go to start of metadata

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

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)

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.


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.

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. 

HTML example

<form action="" 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="">

<input type="hidden"

  name="errorurl" value="">

<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">



  <td>Account number</td>

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



  <td>Sort code</td>

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



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



Redirect example Parameter+%7Bbankaccount%7D+incorrect+or+missing&customermessage= Invalid+account+number.+Please+check+the+information+on+the+card.

  • No labels