Create And Mark Manual Refund (Crypto/WireTransfer/External)
curl --request POST \
--url https://api.unibee.dev/merchant/invoice/create_mark_refund \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"invoiceId": "<string>",
"reason": "<string>",
"refundAmount": 123,
"refundNo": "<string>"
}
'import requests
url = "https://api.unibee.dev/merchant/invoice/create_mark_refund"
payload = {
"invoiceId": "<string>",
"reason": "<string>",
"refundAmount": 123,
"refundNo": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
invoiceId: '<string>',
reason: '<string>',
refundAmount: 123,
refundNo: '<string>'
})
};
fetch('https://api.unibee.dev/merchant/invoice/create_mark_refund', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.unibee.dev/merchant/invoice/create_mark_refund",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'invoiceId' => '<string>',
'reason' => '<string>',
'refundAmount' => 123,
'refundNo' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.unibee.dev/merchant/invoice/create_mark_refund"
payload := strings.NewReader("{\n \"invoiceId\": \"<string>\",\n \"reason\": \"<string>\",\n \"refundAmount\": 123,\n \"refundNo\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.unibee.dev/merchant/invoice/create_mark_refund")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"invoiceId\": \"<string>\",\n \"reason\": \"<string>\",\n \"refundAmount\": 123,\n \"refundNo\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.unibee.dev/merchant/invoice/create_mark_refund")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoiceId\": \"<string>\",\n \"reason\": \"<string>\",\n \"refundAmount\": 123,\n \"refundNo\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"data": {
"refund": {
"adminMemberId": 123,
"countryCode": "<string>",
"createTime": 123,
"currency": "<string>",
"externalRefundId": "<string>",
"gatewayCurrencyExchange": {
"exchange_amount": 123,
"exchange_rate": 123,
"from_currency": "<string>",
"to_currency": "<string>"
},
"gatewayId": 123,
"gatewayRefundId": "<string>",
"invoiceId": "<string>",
"merchantId": 123,
"metadata": {},
"paymentId": "<string>",
"refundAmount": 123,
"refundComment": "<string>",
"refundCommentExplain": "<string>",
"refundId": "<string>",
"refundTime": 123,
"returnUrl": "<string>",
"status": 123,
"subscriptionId": "<string>",
"type": 123,
"userId": 123
}
},
"merchantId": 123,
"message": "<string>",
"redirect": "<string>",
"requestId": "<string>"
}Invoice
Create And Mark Manual Refund (Crypto/WireTransfer/External)
Create a manual refund record for a paid invoice when refund has been processed offline via crypto, wire transfer or External gateway, and mark it as requested. Supports crypto, wire transfer and external invoices.
POST
/
merchant
/
invoice
/
create_mark_refund
Create And Mark Manual Refund (Crypto/WireTransfer/External)
curl --request POST \
--url https://api.unibee.dev/merchant/invoice/create_mark_refund \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"invoiceId": "<string>",
"reason": "<string>",
"refundAmount": 123,
"refundNo": "<string>"
}
'import requests
url = "https://api.unibee.dev/merchant/invoice/create_mark_refund"
payload = {
"invoiceId": "<string>",
"reason": "<string>",
"refundAmount": 123,
"refundNo": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
invoiceId: '<string>',
reason: '<string>',
refundAmount: 123,
refundNo: '<string>'
})
};
fetch('https://api.unibee.dev/merchant/invoice/create_mark_refund', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.unibee.dev/merchant/invoice/create_mark_refund",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'invoiceId' => '<string>',
'reason' => '<string>',
'refundAmount' => 123,
'refundNo' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.unibee.dev/merchant/invoice/create_mark_refund"
payload := strings.NewReader("{\n \"invoiceId\": \"<string>\",\n \"reason\": \"<string>\",\n \"refundAmount\": 123,\n \"refundNo\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.unibee.dev/merchant/invoice/create_mark_refund")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"invoiceId\": \"<string>\",\n \"reason\": \"<string>\",\n \"refundAmount\": 123,\n \"refundNo\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.unibee.dev/merchant/invoice/create_mark_refund")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"invoiceId\": \"<string>\",\n \"reason\": \"<string>\",\n \"refundAmount\": 123,\n \"refundNo\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"data": {
"refund": {
"adminMemberId": 123,
"countryCode": "<string>",
"createTime": 123,
"currency": "<string>",
"externalRefundId": "<string>",
"gatewayCurrencyExchange": {
"exchange_amount": 123,
"exchange_rate": 123,
"from_currency": "<string>",
"to_currency": "<string>"
},
"gatewayId": 123,
"gatewayRefundId": "<string>",
"invoiceId": "<string>",
"merchantId": 123,
"metadata": {},
"paymentId": "<string>",
"refundAmount": 123,
"refundComment": "<string>",
"refundCommentExplain": "<string>",
"refundId": "<string>",
"refundTime": 123,
"returnUrl": "<string>",
"status": 123,
"subscriptionId": "<string>",
"type": 123,
"userId": 123
}
},
"merchantId": 123,
"message": "<string>",
"redirect": "<string>",
"requestId": "<string>"
}Endpoint Overview
POSThttps://api.unibee.dev/merchant/invoice/create_mark_refund
Create a manual refund record for a paid invoice when refund has been processed offline via crypto, wire transfer or External gateway, and mark it as requested. Supports crypto, wire transfer and external invoices.
Authorization
All UniBee Merchant API requests require authentication via API key.| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer <your_api_key> |
Content-Type | Yes | application/json (for request body) |
Parameters
Parameters for this endpoint are listed below. The schema is also shown in the Try it panel.Request body
| Name | Type | Required | Description |
|---|---|---|---|
invoiceId | string | Yes | The unique id of invoice |
reason | string | Yes | The reason of refund |
refundAmount | integer | Yes | The amount of refund |
refundNo | string | No | The out refund number (idempotent key from external system) |
Request examples
cURL
curl -X POST "https://api.unibee.dev/merchant/invoice/create_mark_refund" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"invoiceId": "id_example",
"reason": "",
"refundAmount": 0,
"refundNo": ""
}'
Sandbox
curl -X POST "https://api-sandbox.unibee.top/merchant/invoice/create_mark_refund" \
-H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"invoiceId": "id_example",
"reason": "",
"refundAmount": 0,
"refundNo": ""
}'
Response
Success responses return a JSON envelope withcode, data, message, redirect, and requestId. code 0 indicates success.
| Field | Type | Description |
|---|---|---|
code | integer | Response code. 0 = success |
data | object | Response payload |
data.refund | object | |
message | string | Human-readable message |
requestId | string | Request ID for support |
Error handling
| HTTP status | Meaning |
|---|---|
| 400 | Bad request — invalid or missing parameters. Check message in the body. |
| 401 | Unauthorized — missing or invalid API key. |
| 404 | Not found — invalid path or resource. |
| 500 | Server error — retry with backoff. |
code in the response body is non-zero, check message for details. Use requestId when contacting support.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Create a manual refund record for a paid invoice when refund has been processed offline via crypto, wire transfer or External gateway, and mark it as requested. Supports crypto, wire transfer and external invoices.

