Skip to content

ERIP refund

Refunds for ERIP transactions can be made with an API request or in the merchant back office.

It is possible to make multiple refunds for the same payment transaction; in this case, the total refund amount must not exceed the amount of the corresponding payment transaction.

Info

Refunds for ERIP payments are possible only if the merchant has a sufficient balance of incoming ERIP payments received from participating banks.

Info

Refunds are available only for non-cash payments.

Info

After a successful refund initialization, the transaction receives pending status. Then during the next 11 days it receives either successful or failed status. This timeframe is determined by the time required to process the refund, as well as the possible waiting period for a sufficient amount of incoming ERIP funds to be received. If the refund is not completed within 11 days, bePaid will cancel the refund and send a corresponding notification to the merchant (see Example of a notification for a failed refund).

Info

Refunds are available for payments settled between 24 hours ago and 1 year ago. The date when the payment was settled is available in the Settlement date field on the transaction details page.

Refunds with API

To initiate a refund, send a POST request to https://api.bepaid.by/beyag/refunds with the following parameters:
object
parent_uid
required
 string
UID of the corresponding payment transaction.
reason
required
 string
A note explaining why a refund was made.
amount
required
 integer
Amount to refund in minimal currency units.
Example of a refund request 
{
    "request": {
        "parent_uid": "85861196-e533-4ff0-8330-477050262bd1",
        "reason": "Client request",
        "amount": 50
    }
}
Response example 
{
    "transaction": {
        "type": "refund",
        "refund": {
            "ref_id": "144",
            "message": "Операция успешно создана",
            "status": "pending"
        },
        "id": "091b3006-3c23-4553-88c0-7c86fadef9f6",
        "uid": "091b3006-3c23-4553-88c0-7c86fadef9f6",
        "parent_uid": "f8100e5c-fe45-4053-bae6-e49d60d2589c",
        "message": "Операция успешно создана",
        "status": "pending",
        "amount": 200,
        "currency": "BYN",
        "reason": "Received from service",
        "created_at": "2026-01-14T10:35:54Z",
        "paid_at": "2026-01-14T10:35:54Z",
        "test": false,
        "language": "en",
        "version": 1
    }
}
Example of a successful refund notification 
{
  "transaction": {
    "type": "refund",
    "refund": {
      "ref_id": null,
      "message": "Операция успешно завершена",
      "status": "successful"
    },
    "id": "56d9a41a-bca4-4026-a6e2-905eaaed234f",
    "uid": "56d9a41a-bca4-4026-a6e2-905eaaed234f",
    "parent_uid": "1f708a14-c873-4bb7-97f9-a15232409a89",
    "message": "Операция успешно завершена",
    "status": "successful",
    "amount": 500,
    "currency": "BYN",
    "reason": "Received from service",
    "created_at": "2026-01-08T12:22:16Z",
    "paid_at": "2026-01-08T12:25:00+00:00",
    "test": false,
    "language": "en",
    "version": 1
  }
}
Example of a notification for a failed refund 
{
  "transaction": {
    "type": "refund",
    "refund": {
      "ref_id": "1121",
      "message": "Операция успешно отменена",
      "status": "failed"
    },
    "id": "c3febdfd-c721-4da4-b2c0-c91c79113df7",
    "uid": "c3febdfd-c721-4da4-b2c0-c91c79113df7",
    "parent_uid": "d9b24141-c7b4-48ff-a248-92a299ead018",
    "message": "Операция успешно отменена",
    "status": "failed",
    "amount": 10,
    "currency": "BYN",
    "reason": "Received from service",
    "created_at": "2025-12-03T10:46:29Z",
    "paid_at": "2025-12-15T12:26:57+00:00",
    "test": false,
    "language": "en",
    "version": 9
  }
}

Refunds in the merchant back office

Refunds can also be initiated in the merchant's back office on the Transaction details page. Follow the steps below to make a refund:

1) Find the transaction for which you need to make a refund on the Orders page.

Payments

2) Click Refund. The Refund button is available for payments settled between 24 hours ago and 1 year ago. The date when the payment was settled is available in the Settlement date field.

Refund

3) In the displayed modal window, enter the refund amount and specify the reason for the refund. The amount value must not exceed the amount of the parent transaction. It is possible to make multiple refunds for the same payment transaction, in this case the sum of refund amounts must not exceed the amount of the corresponding payment transaction.

Refund

4) The information on the refund will be displayed on the transaction details page for the refund and the corresponding payment transaction.

Successful refund

Refund cancelled