C-TAP 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.

Order id

For C-TAP payments, MultiSafepay generates the order_id automatically. The order_id is composed of the following properties:

• Terminal ID
• Date of transaction
• The sequential transaction number related to the terminal ID

Format: TERMINALID-DATE-SEQUENCE

Example

100000ABC-261212-1234

Using your own order ID

If you want to use your own order ID, send it in the merchant_reference field of the transaction request. MultiSafepay then uses this value as the order_id instead of generating one.

Refunds

Refunds for C-TAP transactions can only be processed through your MultiSafepay dashboard .

To refund a C-TAP transaction, follow these steps:

1. Sign in to your MultiSafepay dashboard .
2. Go to Transactions > Transaction overview, and click the relevant transaction.
3. On the Transaction details page, click Refund order.
4. In the Reason / Description field, enter the reason for the refund or a description of what happened with the order, and then click Complete.
5. In the Comment field, enter any additional information.
6. In the Amount fields, enter the amount to refund.
7. Click Continue.
8. Review Refund confirmation, and then click Confirm.

Unreferenced refunds

Unreferenced refunds are supported for C-TAP terminals. For more information about how to activate and process unreferenced refunds, see Unreferenced refunds.

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:

1. Sign in to your MultiSafepay dashboard.
2. Go to Devices > Terminals.
3. Click Manage groups.
4. Click + Add new group.
5. Insert a name for your group, and optionally, a logo to enable branding, and a Webhook URL to receive updates for your payments.
6. 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:

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

How to edit a group

1. 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.

2. 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.