Operations guide

Order creation

Order creation via API is not supported for traditional (C-TAP) terminals. Instead, the order must be created directly from the terminal itself using its built-in payment creation options.

Refunds

To process a refund for a C-TAP transaction:

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.

Terminal groups

A terminal group is required for linking and activating a C-TAP device. You can create a single group or multiple groups for segmentation. Each terminal group is assigned a unique API key and ID. All transactions processed by terminals within the same terminal group are consolidated under a single reconciliation history.

This functionality offers reconciliation, reporting and management for single and multiple terminal groups.

How to create a terminal group

To create a terminal group:

Sign in to your MultiSafepay dashboard.
Go to Devices > Terminals.
Click Manage groups.
Click + Add new group.
Insert a name for your group, and optionally, a logo to enable branding, and a Webhook URL to receive updates for your payments.
Click Create.

Your new terminal group will be added to the Manage groups list. A terminal group ID and an API key will be associated.

To view the ID and API key for a terminal group:

Sign in to your MultiSafepay dashboard.
Go to Devices > Terminals.
Click on Manage groups.
A list of all available terminal groups will be displayed, showing the ID and API key for each group.

How to edit a group

At Manage groups click the edit icon on the right side of the panel to edit the desired terminal group. Here, you can:

Change the name of the terminal group.
Change the logo by selecting a different image file.
⚠️Note: Logos are not supported for Traditional terminals.
Change the webhook URL.

Click Save💾

💡 Tip! You can view your API key via Manage groups > API key.

Updates

To get updates on a specific order, make a Get order request using the order_id.

Testing

You cannot test terminals in your MultiSafepay test account.