Skip to main content
POST
/
merchant
/
invoice
/
external_gateway_invoice
/
mark_refunded
Mark External Gateway Invoice As Refunded
curl --request POST \
  --url https://api.unibee.dev/merchant/invoice/external_gateway_invoice/mark_refunded \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalTransactionId": "<string>",
  "invoiceId": "<string>",
  "signature": "<string>",
  "timestamp": 123,
  "gatewayId": 123
}
'
{
  "code": 123,
  "data": {
    "invoiceId": "<string>",
    "refundId": "<string>",
    "status": "<string>"
  },
  "merchantId": 123,
  "message": "<string>",
  "redirect": "<string>",
  "requestId": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Mark external gateway invoice refund as completed (minimal payload). Auth: OpenAPI + signature (HMAC-SHA256, hex).

externalTransactionId
string<string>
required

External refund transaction id from gateway

invoiceId
string<string>
required

Invoice id

signature
string<string>
required

HMAC-SHA256(gatewayKey, invoiceId|externalTransactionId|timestamp), hex

timestamp
integer<int64>
required

Request timestamp, UTC seconds, used for expiry check

gatewayId
integer<int64>

Optional. External gateway id; omit to use invoice's current gateway for auth

Response

200 - application/json
code
integer<int>
data
object
merchantId
integer<int64>
message
string<string>
redirect
string<string>
requestId
string<string>