Event notifications



We currently offer this product in the following countries:

  • Netherlands
  • Belgium

If you are interested in our Point of Sale solutions, email [email protected]

Subscribe to event notifications to receive order payments updates when, e.g.,

  • A customer completes the payment.
  • The payment has been cancelled or declined.


In other scenarios, you can make use of our webhook notifications.

1. Initiate payments

  1. Create an order, and setterminal_id in your request. See Recipe - Cloud POS payment .
  2. In response to the API request you made, you receive the events_token.

📘 Note: You cannot initiate another payment until the current payment is Cancelled or Completed.

2. Subscribe to the event notifications

To subscribe to event notifications make a GET request, using the events_token from your response.

curl -H 'Authorization: events_token' 'https://api.multisafepay.com/events/stream/'
Example requests
curl -H 'Authorization: eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2OTQwNzEyMDcsImdydtdfI6WyJtYnVzOnNlc3Npb24ub3JkZXIiLCJtYnVzOnNlc3Npb24ucXIiXSwicGlkIjoiNTk5TWM0VWhOWDhYczNmNU55b3JnaVZZMlhab1BsVVkxa28iLCJzdWIiOiJwciJ9.p1txKa0wlR6Pn-DvQW8oYmYcesU49GgZsPebME_EvYs' \
Example response
event: session.order
data: {"financial_status":"initialized","order_id":"ExampleOrderID1234567","session_id":"1025J8hXqtM9dLcilPp3gqkXi8Res3tvZZZ","status":"initialized","transaction_id":"89000000"}
event: session.order
data: {"financial_status":"completed","order_id":"ExampleOrderID1234567","session_id":"1025J8hXqtM9dLcilPp3gqkXi8Res3tvZZZ","status":"completed","transaction_id":"890000000"}

3. Payment statuses

The table below sets out possible payment statuses and what they commonly mean.

DescriptionPayment status
The card scheme is processing your payment request.Initialized
The payment has been cancelled on the terminal or via API. For more information - see Cancellation.
Note: You can now initiate another cloud POS payment.
The customer has completed the payment.
Note: You can now initiate another cloud POS payment.
The card scheme has declined the payment. The customer will be redirected to the payment screen to retry the payment.Declined.

Top of page