Configuring the callback URL

Technical requirements

Criterion	Required
Protocol	HTTP or HTTPS
Accessibility	Publicly reachable from the internet
Authentication	No basic auth or token in the URL
Accepted method	POST
Accepted formats	`application/json` and `application/x-www-form-urlencoded`

In production, prefer HTTPS to protect data in transit — even though HTTP is technically accepted by LigdiCash.

Setting the callback at creation

Depending on the transaction type, callback_url is passed in two different places in the request body.

In the commande object — for Payout:

{
  "commande": {
    "callback_url": "https://backend.mygreatshop.com/callback",
    ...
  }
}

In the actions object — for Payin:

{
  "commande": { 
    ...
    "actions": {
      "cancel_url": "https://mygreatshop.com/cancel",
      "return_url": "https://mygreatshop.com/success",
      "callback_url": "https://backend.mygreatshop.com/callback"
    }
    ...
  },
}

You can use a different URL per transaction type or a single URL that dispatches based on the payload content.

Local development

Your local machine is not reachable from the internet. To test the callback locally, use a tunnel like ngrok or Expose, which creates a public HTTPS URL pointing to your local server.

# Example with ngrok
ngrok http 3000
# → https://abc123.ngrok.io receives the POST requests and forwards them to localhost:3000

The ngrok URL changes every time you restart on the free plan. Use a fixed subdomain or deploy to a staging environment for more stable testing.

​Technical requirements

​Setting the callback at creation

​Local development

​Related pages

Technical requirements

Setting the callback at creation

Local development

Related pages