API calls

To complete the API configuration, you need to implement the following 3 API calls.

1. Create order (v2/orders)
   This POST call is mandatory to create the order. In this call, your website sends all the order information to our server (customer details, shipping details, total amount, date, items), and an order token is generated. The customer is then redirected to the Scalapay website to authorise the payment. A 200 response code indicates a successful authorisation.
2. Get order details (v2/payments/{token})
   This GET call checks the status of the order. It retrieves the data and confirms whether the payment has been authorised. During these few seconds, Scalapay’s algorithm performs a real-time check on the payment method used. If the payment is authorised, Scalapay will send a success URL to your website.
3. Capture order (v2/payments/capture)
   This POST call is the final one and is mandatory to correctly finalise the order. Once the capture call is made, the first charge is deducted from the user's account, and the order status is set to "Charged".

ℹ️

Note for travel partners

If you're integrating Scalapay within a travel-booking flow (e.g., flights, hotels, or packages), refer to our Travel API Flow guide.

It outlines the additional considerations and endpoint sequencing specific to the travel vertical.

📘

API Simulator

In this section, you can find the API Simulator, which allows you to test the API calls and see how Scalapay will respond to each one.