SmartPOS solutions
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:
- Enter Amount due and select Pay.
- The customer can either tap or insert their card to make the payment.
- 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
- 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"
}
}'
- Initiate a payment using the URL below:
msp://?amount={$amount}&order_id={$order_id}&callback={$callback_url}¬ification_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
- 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"
}
}'
- To initiate payments - see MultiSafepay Android POS integration .
Handle notifications
The table below sets out options available for receiving updates on the payments.
POS Solutions | Required | Optional |
---|---|---|
Cloud POS payment | Subscribe to the event notifications. | Configure a webhook. |
Web applications | Set callback_url in the link. | Set notification_url in the link to configure a webhook. |
Native applications | Set package_name in your intent call. | Configure a webhook. |
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
How to process refunds
Via the API
See API reference – Refund order.
In your dashboard
- Sign in to your MultiSafepay dashboard .
- Go to Transactions > Transaction overview, and click the relevant transaction.
- On the Transaction details page, click Refund order.
- In the Reason / Description field, enter the reason for the refund or a description of what happened with the order, and then click Complete.
- In the Comment field, enter any additional information.
- In the Amount fields, enter the amount to refund.
- Click Continue.
- Review Refund confirmation, and then click Confirm.
Updates
Make a Get order request to get updates on a specific order.
Testing
You cannot test terminals in your MultiSafepay test account.
Updated 22 days ago