⚠️

Note:

We are currently in the pilot phase for this product.

If you are interested in participating in the next stage of our pilot, email [email protected]

Alternatively to regular refunds, you can process unreferenced refunds. This allows you to return funds to a customer without referring to the original transaction.

Activation

To enable unreferenced refunds for your MultiSafepay account, email [email protected] with the following details:

• Your merchant ID.
• The expected amount of unreferenced refunds per day.
• The maximum amount per unreferenced refund.
• The reason for using unreferenced refunds.
• Why you want to use unreferenced refunds instead of regular refunds.

Payment flow

This diagram shows the flow for a successful transaction. Click to magnify.

User guide

An unreferenced refund is a payment process where you use the funds from your MultiSafepay account balance to process a refund.

Amount limits

• Minimum refund amount: 0,01 EUR
• Maximum refund amount: 60 EUR

Maximum amounts can be adjusted. Send a request to [email protected].

⚠️Note: Remember that to process an unreferenced refund, you must have sufficient funds in your MultiSafepay account balance. To learn how to top your balance, see Top ups .

How it works

SmartPOS terminals

Prerequisites

On your terminal:

• Enable the unreferenced refunds feature.
• For Cloud POS payments, additionally enable Cloud mode.

Check the general flow below:

1. You create an unreferenced refund via
   • Cloud POS OR
   • Manual Input
2. The customer presents their card.
3. The card details are sent to MultiSafepay.
4. The details are forwarded to the card scheme for authorization which can be accepted or declined.
5. Once we receive an authorization response, we forward it to the terminal. The result displays on the screen.

curl --request POST \
--location 'https://api.multisafepay.com/v1/json/orders?api_key={terminal_group_api_key}'\
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
    "type": "unreferenced_refund",
    "order_id": "order_id_example",
    "gateway": "",
    "currency": "EUR",
    "amount": 100,
    "description": "Example order description",
    "payment_options": {
        "notification_url": "https://www.example.com/client/notification?type=notification",
        "notification_method": "POST"
    },
    "customer": {
        "locale": "nl_NL",
        "phone": "031123123123",
        "email": "[email protected]"
    },
    "gateway_info": {
        "terminal_id": "00000ABC"
    }
}'

{
    "success": true,
    "data": {
        "order_id": "example_order_id",
        "session_id": "1045QwhsVpUeasAwdaQWGSACAafascdsa1y",
        "payment_url": "https://payv2.multisafepay.com/connect/fsadfwa4234qdejtcadx/?lang=nl_NL",
        "events_token": "eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NTU5NDc4MzUsImdydCI6WyJtYnVzOnNlc3Npb24ub3JkZXIiLCJtYnVzOnNlc3Npb24ucXIiXSwicGlkIjoiMTA0NVF3aHNWcFVeasfd21lR3UXVKYlZBRUZXd1N3bllDMXkiLCJzdWIiOiJwciJ9.bo7saa1rHZoAcdI7DXH0skVx4EMFm7-EM1P1WfoPCJA",
        "events_stream_url": "https://api.multisafepay.com/events/stream/"
    }
}

Traditional (CTAP) terminals

The steps to process an unreferenced refund may vary from one terminal model to another. Check the general flow below:

1. You initiate the refund by introducing the amount on the CTAP terminal.
2. The customer presents their card.
3. The card details are sent to MultiSafepay.
4. The details are forwarded to the card scheme for authorization which can be accepted or declined.
5. Once we receive an authorization response, we forward it to the terminal. The result displays on the screen.

Payment statuses

Check the table below to learn more about the different statuses:

⚠️Note: For the unreferenced refund to be completed, ensure to have enough balance in your account.

Updates

Check the table below to learn more about how to receive updates for unreferenced refunds:

You can also set up a webhook for your transactions.

Top of page