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

Khởi tạo liên kết​

API dùng để khởi tạo liên kết cho người dùng.

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.

  • binding_data string(2048) required

    Chuỗi JSON chứa thông tin liên kết chi tiết. Mặc định là "" nếu không có dữ liệu.

  • app_trans_id string(40) required

    Mã liên kết Merchant gửi qua hệ thống Zalopay để user thực hiện liên kết (TXID của liên kết). Mã liên kết phải bắt đầu theo format yymmdd của ngày hiện tại.
    Theo format yymmdd_Mã liên kết. Ví dụ: 250210_BindingID.
    Merchant dùng giá trị này cho việc tra cứu thông tin trạng thái liên kết. yymmdd phải đúng TimeZone Vietnam (GMT+7)

  • req_date int64 required

    Thời gian tạo liên kết (unix timestamp in milisecond). Thời gian tính đến milisecond, lấy theo giờ hiện hành

  • max_amount int64 required

    Giá trị mặc định 0

  • redirect_url string(256)

    URL trang liên kết của merchant, sau khi người dùng liên kết thành công, Zalopay sẽ chuyển hướng về trang này với kết kết quả liên kết.

  • redirect_deep_link string(256)

    Deep-link ứng dụng của merchant, sau khi người dùng liên kết thành công, Zalopay sẽ chuyển hướng về trang này với kết kết quả liên kết.

  • binding_type string

    Possible values: [WALLET]

    Giá trị mặc định WALLET

  • callback_url string(256)

    Đây là URL của Merchant, sau khi người dùng liên kết thành công sẽ thông báo kết quả liên kết về cho Merchant, theo phương thức callback (server-to-server).
    callback_url có thể được truyền động theo từng liên kết hoặc cấu hình mặc định trên hệ thống của Zalopay.

  • identifier string(128) required

    Thông tin định danh của người dùng trên hệ thống của merchant, có thể là: id/username ...

  • 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 + | + apps_trans_id + | + binding_data + | + binding_type + | + identifier + | + max_amount + | + req_date.

    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
  • binding_id string

    Mã binding_token của hệ thống Zalopay.

  • deep_link string

    Đường dẫn deep-link dùng để xác nhận thỏa thuận trong ngữ cảnh di động.

  • binding_qr_link string

    URL hiển thị mã QR để người dùng quét xác nhận trên giao diện Web.

  • shor_link string

    Đường dẫn rút gọn xác nhận thỏa thuận trên Web (Merchant tự tạo mã QR từ URL này).

Loading...