Event notifications

⚠️

Note:

We are currently in the pilot phase for this product in the following countries:

  • Netherlands

Please note that in this stage, you cannot request terminals yet to use POS services.
If you are interested in participating in the next stage of our pilot, 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.

Prerequisites

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://testapi.multisafepay.com/events/stream/'
Example requests
curl -H 'Authorization: eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE2OTQwNzEyMDcsImdydtdfI6WyJtYnVzOnNlc3Npb24ub3JkZXIiLCJtYnVzOnNlc3Npb24ucXIiXSwicGlkIjoiNTk5TWM0VWhOWDhYczNmNU55b3JnaVZZMlhab1BsVVkxa28iLCJzdWIiOiJwciJ9.p1txKa0wlR6Pn-DvQW8oYmYcesU49GgZsPebME_EvYs' \
'https://testapi.multisafepay.com/events/stream/'

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.
Cancelled.
The customer has completed the payment.
Note: You can now initiate another cloud POS payment.
Completed
The card scheme has declined the payment. The customer will be redirected to the payment screen to retry the payment.Declined.

Top of page