⚠️

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]

Our SmartPOS solutions let you initiate payments through:

• Manual input
• Cloud POS payment
• On-same device third-party applications
  • Web application
  • Native application

Manual input

To start processing payments manually:

1. Enter Amount due and select Pay.
2. The customer can either tap or insert their card to make the payment.
3. Once the payment is completed, a notification is displayed.

Cloud POS payment

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.

📘 Note: Before you start initiating payments, you must ensure cloud mode is enabled - see SmartPOS features.

Create an order. See Recipe - Cloud POS payment .

To receive payments updates subscribe to Event notifications.

On-same device third-party applications

Web applications

Web applications let you initiate payments on-same devices from a browser to the payment app.

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

Initiate payments

1. Before initiating web application payments, you need to create an order.

Example

curl -X POST \
"https://api.multisafepay.com/v1/json/orders?api_key={your-api-key}"
-d '{
  "type": "redirect",
  "order_id": "my_order_id",
  "gateway": "",
  "currency": "EUR",
  "amount": 10,
  "description": "Order Description",
  "payment_options": {
      "notification_url": "https://www.example.com/paymentnotification",
      "notification_method": "POST"
  }
}'

2. Initiate a payment using the URL below:

msp://?amount={$amount}&order_id={$order_id}&callback={$callback_url}&notification_url={$notification_url}

• amount: the amount specified in EUR cents.
• order_id: Your unique identifier for order ID.
• callback_url: This URL redirects the customer to receive payment status notifications.
• Optionally, you can set notification_url to receive order payment updates notifications.

Payment status received can either be Completed or Cancelled.

Native applications

Native applications let you initiate payments on-same devices from app to payment app.

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

Initiate payments

1. Before initiating native application payments, you need to create an order.

Example

curl -X POST \
"https://api.multisafepay.com/v1/json/orders?api_key={your-api-key}"
-d '{
  "type": "redirect",
  "order_id": "my_order_id",
  "gateway": "",
  "currency": "EUR",
  "amount": 10,
  "description": "Order Description",
  "payment_options": {
      "notification_url": "https://www.example.com/paymentnotification",
      "notification_method": "POST"
  }
}'

2. To initiate payments - see MultiSafepay Android POS integration .

Handle notifications

The table below sets out options available for receiving updates on the payments.

User guide

Cancellation

To cancel an order, make a POST request using the order_id.

curl -X POST 'https://testapi.multisafepay.com/v1/json/orders/{order_id}/cancel?api_key={your-api-key}'

Refunds

Updates

Make a Get order request to get updates on a specific order.

Testing

You cannot test terminals in your MultiSafepay test account.

Top of page