Configure your webhook endpoint


MultiSafepay uses a webhook to send updates about orders and other notifications to your web server.

You can configure the webhook at website level or at order level.

Requirements

You must set a webhook endpoint, which is a URL that:

  • Doesn’t include port numbers.
  • Is publicly accessible, or has MultiSafepay on your allow list.
  • Uses HTTPS - We don’t accept HTTP for security reasons.

For a list of MultiSafepay IP addresses, email [email protected]

Website level

To configure the webhook endpoint at website level:

  1. Sign in to your MultiSafepay account.
  2. Go to Settings > Website settings.
  3. Select the relevant website.
  4. In the Notification URL field, set your webhook endpoint.

Order level

To configure the webhook endpoint at order level:

  1. Create an order via our API.

  2. In the request body, set:

    • payment_options.notification_url to your webhook endpoint
    • payment_options.notification_method to POST
    Note We do support GET as a notification_method, but we strongly recommend to use POST, which is the most efficient.

Example:

curl -X POST \
"https://api.multisafepay.com/v1/json/orders?api_key={your-api-key}"
-d '{
  "type": "redirect",
  "order_id": "my-order-id-1",
  "currency": "EUR",
  "amount": 1000,
  "description": "product description",
  "payment_options": {
      "notification_url": "https://www.example.com/paymentnotification",
      "notification_method": "POST"
  }
}'

Now that you have configured your webhook endpoint, you need to configure your web server to handle notifications correctly.

Next steps

Feedback

Propose a change on GitHubexternal-link-icon or
send an email to [email protected]

Other languages

For an explanation in another language, contact your account manager.