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

Truy vấn mã thông báo thanh toán của một liên kết​

Truy vấn mã thông báo thanh toán của một liên kết

Request Body required

Agreement Query

  • app_id int64 required

    ID duy nhất của ứng dụng sẽ được cung cấp sau khi nhà cung cấp đăng ký thành công với Zalopay.

  • app_trans_id string required

    ID giao dịch duy nhất của ứng dụng, định dạng: yyMMddxxxxxxxxx. Độ dài tối đa là 40 ký tự. Ví dụ: 180208181007242.

  • req_date int64 required

    Thời điểm hiện tại tính bằng mili giây (milliseconds).

  • mac string required

    Đây là chữ ký của đơn hàng. Nó được tính bằng cách sử dụng thông tin đầu vào như sau: hmacinput = app_id + | + apps_trans_id + | + req_date; và sử dụng SHA256 với khóa HMAC của ứng dụng làm khóa chữ ký.

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

Responses

OK

Schema
  • return_code integer

    Mã trả về:

    1 - THÀNH CÔNG

    2 - THẤT BẠI

    3 - ĐANG CHỜ

  • return_message string
  • sub_return_code integer
  • sub_return_message string
  • data object
  • app_id int64

    "App ID" của nhà cung cấp

  • app_trans_id string

    ID duy nhất của nhà cung cấp cho liên kết.

  • binding_id string

    ID của liên kết đã được xác nhận trong hệ thống Zalopay.

  • pay_token string

    "Public token" được sử dụng khi thực hiện tự động trừ tiền

  • server_time int64

    Thời điểm của máy chủ (server timestamp) tính bằng giây (seconds).

  • merchant_user_id string

    Trường "identifier" trong yêu cầu liên kết

  • status integer

    1: Đã xác nhận, 3: Đã hủy, 4: Đã vô hiệu hóa.

  • msg_type integer

    Loại tin nhắn: 1: Người dùng xác nhận một hợp đồng 2: Người dùng cập nhật hợp đồng

  • zp_user_id string

    Định danh của người dùng Zalopay theo app_id của nhà cung cấp.

  • masked_user_phone string

    Số điện thoại của người dùng bị ẩn (Ví dụ: masked_user_phone: "****6938").

Loading...