Chuyển đến nội dung chính

Truy vấn trạng thái lệnh chi tiền​

API dùng để truy vấn trạng thái lệnh chi tiền.

Request Body required
  • app_id int64 required

    Định danh cho ứng dụng (web, app, pos ...) hay dịch vụ (auto-debit, disbursement ...) của Merchant được cấp khi đăng ký tích hợp phương thức thanh toán với Zalopay.

  • partner_order_id string required

    Mã giao dịch Merchant gửi qua hệ thống Zalopay để thực hiện lệnh chi hộ (TXID của giao dịch chi hộ).

  • time int64 required

    Thời gian gửi yêu cầu truy vấn (unix timestamp in milisecond). Thời gian tính đến milisecond, lấy theo giờ hiện hành.

  • mac string required

    Thông tin chứng thực: mac = HMAC(hmac_algorihtm, mac key, hmacinput), chi tiết như bên dưới:
    - hmac_algorihtm: là phương thức bảo mật được Merchant đăng ký với Zalopay, mặc định là HmacSHA256.
    - mac key: được cung cấp bởi Zalopay.
    - hmac_input = app_id + | + partner_order_id + | + time.

    Vui lòng tham khảo phần truyền dữ liệu an toàn để biết thêm chi tiết.

Responses

OK

Schema
  • return_code integer

    Mã trạng thái.
    Vui lòng tham khảo mã trạng thái để biết thêm chi tiết.

  • return_message string

    Mô tả mã trạng thái.

  • sub_return_code integer

    Mã trạng thái chi tiết.
    Vui lòng tham khảo mã trạng thái để biết thêm chi tiết.

  • sub_return_message string

    Mô tả mã trạng thái chi tiết.

  • data object
  • order_id string

    Định danh giao dịch của hệ thống Zalopay.

  • disbursement_type string

    Loại chi hộ: WALLET hoặc BANK

  • m_u_id string

    Thông tin định danh người dùng của Zalopay.
    Chú ý: Chỉ trả về khi disbursement_type = "WALLET".

  • phone string

    Thông tin số điện thoại đăng ký Zalopay đã được che dấu. Ví dụ: masked_user_phone: "****6938".
    Chú ý: Chỉ trả về khi disbursement_type = "WALLET".

  • bank_code string

    Mã Ngân hàng thụ hưởng.
    Chú ý: Chỉ trả về khi disbursement_type = "BANK".

  • account_no string

    Số tài khoản thụ hưởng.
    Chú ý: Chỉ trả về khi chi qua tài khoản Ngân hàng (account), disbursement_type = "BANK".

  • account_holder_name string

    Tên tài khoản thụ hưởng.
    Chú ý: Chỉ trả về khi chi qua tài khoản Ngân hàng (account), disbursement_type = "BANK".

  • card_no string

    Số thẻ thụ hưởng.
    Chú ý: Chỉ trả về khi chi qua tài khoản Ngân hàng (account), disbursement_type = "BANK".

  • card_holder_name string

    Tên thẻ thụ hưởng.
    Chú ý: Chỉ trả về khi chi qua tài khoản Ngân hàng (account), disbursement_type = "BANK".

  • status integer

    Trạng thái thực hiện lệnh chi.
    - 1 SUCCESS: GiaO dịch thành công.
    - 2 FAIL: Giao dịch thất bại.
    - 3 PROCESSING: Giao dịch đang được hệ thống xử lý, merchant lặp lại gọi API Query Transaction (/v2/disbursement/query-txn) trong một khoảng thời gian để truy vấn cho đến khi đạt trạng thái cuối cùng.
    - 4 PENDING: Giao dịch đang chờ xử lý, cần liên hệ OP Zalopay để hỗ trợ.

  • amount int64

    Số tiền chi của giao dịch.

  • partner_fee int64

    Phí chi hộ của merchant.

  • zlp_fee int64

    Phí chi hộ của Zalopay.

  • server_time int64

    Thời gian bắt đầu xử lý của hệ thống.

Loading...