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

Want a quick overview?