---
updatedAt: 2026-04-06T14:32:13.000Z
agentTools:
  projectIndex: https://docs.multisafepay.com/llms.txt
---

# Cloud POS payment

```curl cURL
curl --request POST \
     --url 'https://testapi.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": "test-663",
  "gateway": "",
  "currency": "EUR",
  "amount": 100,
  "description": "Test Order Kiosk Description",
  "payment_options": {
    "notification_url": "https://www.example.com/event/notifications",
    "notification_method": "POST"
    },
  "customer": {
      "locale": "nl_NL",
      "phone": "0612345678",
      "email": "example@multisafepay.com"
  },
  "gateway_info": {
          "terminal_id": "000000MB"
  }
}
```

```json Response Example
{
   "success":true,
   "data": {
       "order_id": "test-663",
       "payment_url": "https://testpayv2.multisafepay.com/connect/216OZwLaVQwre3FUd7W3kfvQ0CcEedaOgGm/?lang=nl_NL", 
       "session_id": "243erLaVQwre3FUd7W3kfvQ0CcEedaOgGm", 
       "events_token": "eyJhbGciOitresfjNiJ9.yfdhwOjE2ODQ5MTc0NzcsImdydCI6WyJtYnVzOnNlc3Npb24ub3JkZXIiLCJtYnVzOnNlc3Npb24ucXIiXSwicGlkIjoiMjE2T1p3TGFWUXdyZTNGVWQ3VzNrZnZRMENjRWVkYU9nR20iLCJzdWIiOiJwciJ9.TDf4Kx0ihNBxKrHD1DtBVcjjA2qBqM9IfQXNX_iAlmk", 
       "events_stream_url": "https://testapi.multisafepay.com/events/stream/"
   }
}
```

# Specify the flow

<!-- curl@1-21 -->

Create an order (see [recipes](/recipes/create-a-payment-pagelink) ) and fill in the required parameters.

To retrieve your group API key:

1. Sign in to your [MultiSafepay dashboard](https://merchant.multisafepay.com/).
2. Go to **Devices** > **Terminals**, and then click **Manage groups**.
3. In the **Manage groups** dialog, hover the **key** icon.

# Specifiy terminal ID

<!-- curl@22-24 -->

To specify terminal ID, set `gateway_info` (string) including:

- `terminal_id`: The unique alphanumerical identifier of the terminal.

To view the `terminal_id`:

- Sign in to [MultiSafepay dashboard](https://merchant.multisafepay.com/). 
- Go to  **Devices** > **Terminals**.
- Your `terminal_id` is displayed under **TID**.

# Optionally, subscribe to event notifications



1. In the response, you receive `events_tokens` and `events_stream_url`. Pass the events_token and events_stream_url to your backend.

Check the [Event notifications](/recipes/subscribe-to-event-notifications-1) recipe to learn how to subscribe to status updates notifications.