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

Tạo một liên kết mới cho hợp đồng đồng thuận​

Tạo một liên kết mới cho hợp đồng đồng thuận

Request Body required

Liên kết cho hợp đồng đồng thuận

  • 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 (timestamp) khi đơn hàng được tạo ra, tính bằng mili giây (ms). Giới hạn khác biệt là 15 phút.

  • max_amount int64

    Số tiền tối đa được phép. Giá trị mặc định là số dư thực.

  • redirect_url string

    "URL của trang liên kết của nhà cung cấp (web), được sử dụng trong kịch bản liên kết trên desktop. Sau khi quá trình liên kết hoàn tất, trang tự động nạp tiền Zalopay sẽ chuyển hướng đến trang liên kết của nhà cung cấp thông qua URL chuyển hướng với kết quả liên kết."

  • redirect_deep_link string

    "Đường dẫn sâu (deep-link) của ứng dụng nhà cung cấp, được sử dụng trong kịch bản liên kết trên điện thoại di động. Sau khi quá trình liên kết hoàn tất, ứng dụng Zalopay sẽ mở ứng dụng nhà cung cấp thông qua đường dẫn sâu chuyển hướng (redirect deep link) với kết quả liên kết."

  • binding_data string

    Chuỗi JSON chứa thông tin liên kết (binding), mô tả thông tin mà người dùng sẽ đồng ý cho phép nhà cung cấp (merchant) thực hiện bằng việc xác nhận liên kết

  • binding_type string

    Possible values: [WALLET]

    Trường này xác định loại liên kết (binding), hiện tại chỉ cho phép loại liên kết là WALLET. Nếu không được cung cấp, giá trị mặc định là WALLET.

  • callback_url string

    TBD

  • identifier string required

    Định danh người dùng trên hệ thống của nhà cung cấp (merchant), có thể là mã người dùng của nhà cung cấp, số điện thoại, địa chỉ email...

  • 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 + | + binding_data + | + binding_type + | + identifier + | + max_amount + | + 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 - SUCCESS

    2 - FAIL

    3 - PROCESSING

    -500 - SYSTEM_ERROR

    -429 - LIMIT_REQUEST_REACH

    406 - ILLEGAL_STATUS

    -405 - ILLEGAL_CLIENT_REQUEST

    -403 - ILLEGAL_SIGNATURE_REQUEST

    -402 - ILLEGAL_APP_REQUEST

    -401 - ILLEGAL_DATA_REQUEST

  • return_message string
  • sub_return_code integer
  • sub_return_message string
  • binding_id string
  • binding_url string
Loading...