Introduction

This documentation provides instructions for how to integrate HeidiPay, Pagolight or Pagolight Pro as payment method into your webshop.

This REST Checkout API works with similar logic to most modern payment gateways, being based on a redirect process, combined with order status webhooks.

It covers the following functionalities that you can manage directy via REST API integration:

For all payment methods (HeidiPay, Pagolight or Pagolight Pro):

• Create a new credit application (summary - detailed documentation)
• Refund request (summary - detailed documentation)
• Confirm order delivery (only relevant for non-automatic merchant order confirmation mode) (summary - detailed documentation)
• Check the status of a credit application (summary - detailed documentation)
• Download the list of your customer contracts (summary - detailed documentation)

For Switzerland only (HeidiPay):

• Simulate financial terms for an order (e.g. interest rate, monthly instalment) (summary - detailed documentation)

Please note that most of the intructions are valid for all our payment methods. Should there be any specific requirement for one of the payment methods (e.g. Pagolight Pro), we we will clearly indicate it in the relevant documentation section.

For any questions related to the integration or to request a sandbox Private API key for demo purpose, please contact:

• For HeidiPay (Switzerland): [email protected]
• For Pagolight & Pagolight Pro (Italy): [email protected]