Hủy giao dịch

API hủy giao dịch cho phép bạn void (hủy) một giao dịch thanh toán thẻ đã thành công trước khi quyết toán.


Điều kiện hủy giao dịch

Chỉ cho phép hủy giao dịch khi thỏa mãn các điều kiện sau:
  1. Chỉ cho hủy giao dịch khi thanh toán bằng thẻ (payment_method=CARD).
  2. Chỉ cho hủy giao dịch khi trạng thái đơn hàng là CAPTURED (order_status=CAPTURED).
  3. Chỉ cho hủy giao dịch khi chưa đến thời điểm quyết toán. Lịch quyết toán:
    • Trước 16:00 (4 giờ chiều): Tiền về ngày làm việc kế tiếp (T + 1).

      Ví dụ: Giao dịch lúc 15:30 Thứ 3 (T3) → Tiền về Thứ 4 (T4).

    • Sau 16:00 (4 giờ chiều): Tiền về sau 2 ngày làm việc (T + 2).

      Ví dụ: Giao dịch lúc 17:00 Thứ 3 (T3) → Tiền về Thứ 5 (T5).

    • Sau 16:00 Thứ 6 (T6): Tiền về Thứ 2 tuần kế tiếp (T2).

API Endpoint

POST
https://pgapi-sandbox.sepay.vn/v1/order/voidTransaction

API Request

order_invoice_numberstringrequired

Mã hóa đơn của giao dịch thanh toán cần hủy

API Response

Success Response (200)
{
  "message": "Đã hủy giao dịch thành công"
}
messagestring

Thông báo kết quả

Code mẫu

>
>
>
>
>
curl --request POST \
--url https://pgapi-sandbox.sepay.vn/v1/order/voidTransaction \
--header 'Authorization: Basic REPLACE_BASIC_AUTH' \
--header 'content-type: application/json' \
--data '{"order_invoice_number":"DH1756370479"}'