Quick Start Guide
While most of the code relates to API usage errors, there are a few that are critical to users' experience.
Improve your users' experience with a few simple tasks.
<customer-message>is included in the PAYMENT_REQUEST response, display its value in the frontend.
<customer-message>is not included, there is most likely an error in the use of the API. Check the
<reason-code>for more details. Display your own generic error message to customers.
A successfully processed PAYMENT_REQUEST is answered with reason code 700.
If you have not already done so, save the transaction in your system, submit your order ID within a PAYMENT_CONFIRMATION request to Ratepay and forward your customers to the next page.
In case of result code 150 it could be possible to complete the purchase order with a new transaction.
Your customers should be able to validate and correct the data they provided.
In case we reject your PAYMENT_REQUEST you will get result code 401.
Your customers should be able to select a different payment method, like Credit Card or Prepayment, or it should be possible for the customer to correct their data, depending on the responded Reason Code.
Log the reason codes to identify possible technical errors and constantly improve your users' experience.