Danh sách giao dịch

API này dùng để lấy danh sách giao dịch của đối tác, phục vụ việc đối soát và xác nhận thanh toán cuối tháng.

HTTP request

• URL: /api/general/v1/partner/billing/transactions
• Method: GET
• Content Type: application/json
• Response Type: application/json

Tham số header

Header	Mô tả	Kiểu dữ liệu	Bắt buộc
X-Api-Key	Khóa duy nhất.	string	có

Tham Số Truy Vấn (Query Parameters)

Tên Tham Số	Kiểu Dữ Liệu	Bắt buộc	Mô Tả
page	string	không	Trang dữ liệu cần lấy, default: 0.
size	string	không	Số bản ghi của một trang, default: 10.
recvWindow	string	không	Thời gian chấp nhận (ms), default: 5000.
timestamp	string	có	Unix timestamp (milliseconds).
signature	string	có	HMAC-SHA256 signature.

Phản Hồi (Response)

Response Mẫu

{
  "status": 200,
  "message": "Success",
  "total": 13,
  "data": [
    {
      "externalUserId": "USER019",
      "transactionId": "932e3d0e-552b-4893-8d8a-797f928d38eb",
      "orgTransactionId": "TXN_17694879651798",
      "billingNo": "BLYRX0UYKQTUYEFA",
      "amount": 100000,
      "payTransactionDate": "2026-02-28T10:00:00.000+00:00",
      "paymentStatus": "SUCCESS",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "3ed1be44-70d3-427a-8f16-7f6178e1a163",
      "orgTransactionId": "BRBKM88LUUS8USW6_123456785656",
      "billingNo": "BYWWGD43QPUWMX3X",
      "amount": 100000,
      "payTransactionDate": "2026-02-10T17:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "509db981-252b-49bf-85e7-dae9a6ae8db0",
      "orgTransactionId": "BRBKM88LUUS8USW6_12345678",
      "billingNo": "BRBKM88LUUS8USW6",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T17:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "373da460-0a5f-42d1-bf9e-7c6406172d43",
      "orgTransactionId": "12",
      "billingNo": "BZVBZEXWVCACFVAD",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "SUCCESS",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "bbd8a770-91d7-461b-b570-8c3c5cab5d65",
      "orgTransactionId": "12",
      "billingNo": "BED6LZISM1HEIMJW",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "a00291e4-af8f-4082-ae8a-a9e35ec647cc",
      "orgTransactionId": "123",
      "billingNo": "BAMJ0NG7CBX5EJDQ",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "SUCCESS",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "a8658673-0236-41fb-9921-b080d0b4846a",
      "orgTransactionId": "123",
      "billingNo": "BA8IBKAEADEBIOWD",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "c502c126-94b0-465c-821c-d7f3921379d5",
      "orgTransactionId": "124",
      "billingNo": "BA8IBKAEADEBIOWD",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "ebd601a0-6a76-42dd-99e7-b9eb5ed4f828",
      "orgTransactionId": "dggd",
      "billingNo": "BKMNVQU4UVVHDLEF",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    },
    {
      "externalUserId": "SKYLINK_FLOW_TEST_1767843369374_STATS",
      "transactionId": "7b5419c7-a847-4139-aa25-22c06a5038db",
      "orgTransactionId": "dggd",
      "billingNo": "BKMNVQU4UVVHDLEF",
      "amount": 100000,
      "payTransactionDate": "2026-02-09T00:00:00.000+00:00",
      "paymentStatus": "WAIT_FOR_CONFIRM",
      "note": "Cập nhật tùy chỉnh Nebula Ultra"
    }
  ]
}

Chi Tiết Tham Số Response

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
status	number	Mã trạng thái HTTP.
message	string	Thông báo kết quả xử lý.
total	number	Tổng số hoá đơn.
data	array (Xem chi tiết)	Dữ liệu danh sách các hoá đơn.

Cấu trúc thuộc tính data

Quay lại

Tên Thuộc Tính	Kiểu Dữ Liệu	Mô Tả
externalUserId	string	UserId của đối tác.
transactionId	string	Mã giao dịch trên hệ thống Nebula.
orgTransactionId	string	Mã giao dịch gốc từ phía đối tác.
billingNo	string	Mã hoá đơn.
amount	number	Số tiền giao dịch.
payTransactionDate	string	Ngày thanh toán (Định dạng: yyyy-MM-dd'T'HH:mm:ss.SSS'Z').
paymentStatus	string	Trạng thái thanh toán: - WAIT_FOR_CONFIRM: Chờ đối soát - SUCCESS: Thành công - FAILED: Thất bại - CANCELED: Đã hủy
note	string	Ghi chú giao dịch.