Integration Process
Getting Started
You can start accepting payments with default pre-built checkout pages or customise the user interface for complete control over your checkout experience.
Steps to follow
Create a payment transaction request
You can create a sample request of your own or you can use the following sample request (a very basic one) to call our API:
{
"storeId": "72305408",
"transactionType": "SALE",
"transactionAmount": {
"currency": "EUR",
"total": 12.99
}
}
A wide range of further parameters allows you to include things like billing and shipping address, order details, settings for 3-D Secure exemptions, your own transaction identifiers, etc.
After your successful request, you get a URL for the redirection of your customer to our solution and a checkout ID.
{
"checkout": {
"storeId": "72305408",
"checkoutId": "-YHeus",
"redirectionUrl": "https://ci.checkout-lane.com/#/?checkoutId=-YHeus"
}
}
Redirect your customer
Once you have received a success response from our API, use the redirectionURL
, to redirect your customer to your active checkout page.
Webhooks
We use webhooks to notify you the moment a transaction changes its status.
Webhooks enable us to post real time notifications to your application via HTTP POST requests to the URL endpoints that you defined. All successfully received webhook messages must return an HTTP 200 status code. If the endpoint responds with a status code not in the range, the webhook assumes that your endpoint did not receive the message and retries later. If the configured retry attempts are exhausted, we send an offline notification.
Before you enable webhooks
- Create a webhook endpoint on your server (HTTP endpoint)
- Make sure it accepts POST requests with a JSON payload
Updated 13 days ago