This guide provides implementation details and examples for each supported MultiSafepay POS payment flow.

Before integration, ensure that the terminal is connected to a stable network and has been activated from your MultiSafepay dashboard.

Manual input

Manual input allows you to process standalone transactions from the MultiSafepay payment application and does not require additional integration steps.

How to initiate a payment

To process a payment using Manual input:

1. Enter Amount due and select Pay.
2. The customer taps or inserts their card to complete the payment.
3. When the payment is completed, a confirmation is displayed on the device.

Payments processed with Manual input are automatically assigned an order_id.

To use a custom order_id, choose one of the following methods:

Cloud POS payments

With cloud POS payment, you can initiate payments from an external application.

This diagram shows a successful cloud-based POS payment flow. Click to magnify.

Integration steps

Check the example in the dropdown below to see how the request is sent to our server.

curl --request POST \
  --url 'https://api.multisafepay.com/v1/json/orders?api_key=YOUR_GROUP_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "redirect",
  "order_id": "your-order-id",
  "currency": "EUR",
  "amount": 100,
  "description": "Order description",
  "payment_options": {
    "notification_url": "https://www.example.com/event-notifications",
    "notification_method": "POST"
  },
  "gateway_info": {
    "terminal_id": "your-terminal-id"
  }
}'

{
  "success": true,
  "data": {
    "order_id": "your-order-id",
    "payment_url": "https://pay.multisafepay.com/your-payment-url",
    "session_id": "your-session-id",
    "events_token": "your-events-token",
    "events_stream_url": "https://api.multisafepay.com/events/stream/"
  }
}

How to initiate a payment

After integrating Clous POS payments into your system, you can process your first payment. Make sure you have correctly integrated Cloud POS payments. <i class="fa fa-external-link" style={{ fontSize:'12px', color:'#8b929e' }}>

To complete a Cloud POS payment:

Web applications

Web applications allow you to initiate payments from a browser to the MultiSafepay payment app on the same device.

This diagram shows a successful web application payment flow. Click to magnify.

Integration steps

How to initiate a payment

After completing the integration, you can initiate payments from your web application.

Native applications

Native applications let you initiate payments from your app to the MultiSafepay payment app on the same device.

This diagram shows a successful native application payment flow. Click to magnify.

Integration steps

How to initiate a payment

After completing the integration, you can initiate payments from your native application.

Next step