Hủy phiếu thu. Kết quả giống thao tác hủy phiếu trên màn quản trị.| Phiếu trước khi hủy | Kết quả |
|---|
| Chờ duyệt | Phiếu chuyển sang Đã hủy. Số tiền đã thu của đơn không đổi (phiếu chưa duyệt chưa được tính) |
| Đã duyệt | Phiếu chuyển sang Đã hủy, số tiền đã thu của đơn bị trừ lại tương ứng |
| Đã hủy | Không thay đổi gì, trả 200 với message Receipt already canceled |
Gọi lặp an toàn: gửi lại cùng request không gây thay đổi thêm. Có thể thử lại khi timeout.
Phiếu đã hủy không duyệt lại được (Confirm Receipt Success trả 409). Cần thu lại thì tạo phiếu mới.
Lý do hủy (reason) được ghi vào lịch sử phiếu, kèm nguồn open_api.
Phiếu đã hủy không còn gắn với đơn, nên không hiện khi lọc Get all receipt theo payment_code.
Hệ thống tích hợp cần lưu id phiếu từ lúc tạo.
Chỉ áp dụng cho phiếu thu. ID là phiếu chi → 400.
Request
Provide your bearer token in the Authorization
header when making requests to protected resources. Example:Authorization: Bearer ********************
Body Params application/json
{
"reason": "Khách hủy đơn, hoàn tiền qua cổng thanh toán"
}
Request Code Samples
curl --location 'https://demo.tourwell.net/billings/receipts/5551/cancel' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"reason": "Khách hủy đơn, hoàn tiền qua cổng thanh toán"
}'
Responses
application/json
{
"success": true,
"message": "Receipt canceled successfully",
"data": {
"id": 5551,
"code": "PT1150",
"is_canceled": true,
"was_approved": true,
"order_ids": [
23284
]
}
}
Modified at 2026-11-17 02:18:38