API Chi tiết giao dịch

API lấy thông tin chi tiết của một giao dịch cụ thể dựa trên transaction_id. Hỗ trợ tra cứu thông tin đầy đủ về một giao dịch.


API Endpoint

GET
https://bankhub-api-sandbox.sepay.vn/v1/transaction/{transaction_id}

Path Parameters

transaction_idstringrequired

Mã giao dịch duy nhất

Lưu ý
  • API này yêu cầu Bearer Token trong header Authorization
  • Transaction ID phải tồn tại trong hệ thống
  • Trả về thông tin chi tiết đầy đủ của một giao dịch
  • Bao gồm cả thông tin tài khoản ảo (VA) nếu có

Xử lý lỗi

401Unauthorized

Access token không hợp lệ hoặc đã hết hạn

404Not Found

Giao dịch không tồn tại hoặc không thuộc merchant này

API Response

Response 200 - Thành công
{
  "data": {
    "transaction_id": "string",
    "transaction_date": "string",
    "bank_account_xid": "string",
    "company_xid": "string",
    "brand_name": "string",
    "account_number": "string",
    "va": "string",
    "va_xid": "string",
    "reference_number": "string",
    "transfer_type": "in",
    "amount": 0,
    "transaction_content": "string",
    "payment_code": "string",
    "webhook_success": 0
  }
}
dataobject

Code mẫu

1
2
3
curl --request GET \
--url https://bankhub-api-sandbox.sepay.vn/v1/transaction/a47b6ab2-8f8b-11f0-b21a-a6006ab65aca \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Ví dụ sử dụng

JSLấy chi tiết giao dịch
1
2
curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/transaction/123456' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Lưu ý
  • Transaction ID: Phải là ID hợp lệ tồn tại trong hệ thống
  • 404 Error: Nếu transaction_id không tồn tại, API sẽ trả về lỗi 404
  • VA Fields: Trường vava_xid chỉ có giá trị với giao dịch qua tài khoản ảo
  • Payment Code: Được tự động trích xuất từ transaction_content dựa trên cấu hình merchant