2. Refund

POST 
/api/v3/remote-pos/{source_pid}/remote-action/refund

Creates a REFUND remote-action which will be retrieved and processed by the target terminal.

Parameters:

Same as the purchase.

Parameter	Type	Required	Description	Example
sourcePid	string	yes	Obtained on the portal — unique Hexa ID identifying the POS	200010001001
targetPid	string	yes	Unique Hexa identifier (target) which will receive the action	term_01
amount	integer (cents)	yes	Amount in cents (1 = 0.01€)	100 (1.00€)
shouldPrintReceipt	integer (0 / 1)	yes	1 = print, 0 = no print
webhook	string (URL)	no	Callback URL invoked after processing	https://webhook.site
allowedPaymentMethodIds	array	no	Allow specific payment methods (cards (30), giftcard (20))	[30, 20]

Request

Responses

201

Example

{
  "success": true,
  "data": {
    "id": 23,
    "uuid": "49b55f65-dc16-48a1-a906-0b23cfdbd211",
    "sourcePid": "210200010003",
    "targetPid": "200200010003",
    "groupId": 843,
    "groupName": "Shop - Group 2",
    "remoteActionStatusId": 100,
    "remoteActionStatus": "Pending",
    "remoteActionStatusAt": "2026-02-11T07:41:27.000000Z",
    "remoteActionTypeId": 20,
    "remoteActionType": "REFUND",
    "updatedAt": "2026-02-11T07:41:27.000000Z",
    "createdAt": "2026-02-11T07:41:27.000000Z",
    "webHook": "http://localhost:2010/testhook",
    "linkedObjectType": null,
    "linkedObjectId": null,
    "details": {
      "requestedAmount": 1,
      "paidAmount": null,
      "shouldPrintReceipt": 0,
      "allowedPaymentMethodIds": null,
      "orderUuid": null,
      "operations": null
    }
  }
}