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

Thiết lập liên kết toán bằng token​

Thiết lập liên kết toán bằng token

Request Body required

Tokenization Binding

  • 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.

  • 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.

  • 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.

  • 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...

  • binding_type string required

    Possible values: [WALLET, CARD]

    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 hoặc CARD.

  • binding_mode string required

    Possible values: [BIND, BIND_AND_PAY]

    Trường này xác định chế độ liên kết (binding), hiện tại chỉ cho phép chế độ liên kết là BIND hoặc BIND_AND_PAY.

  • device_type string required

    Possible values: [MOBILE, DESKTOP]

    Trường này xác định loại thiết bị mà người dùng đang sử dụng, hiện tại chỉ cho phép loại thiết bị là MOBILE hoặc DESKTOP.

  • binding_data string required

    Dữ liệu riêng của ứng dụng. Sử dụng "{}" nếu trống.
    Chuỗi JSON bao gồm thông tin đặc biệt của liên kết.
    Các trường đặc biệt của binding_data:
    redirect_url

    + DataType: string
    + Format: URL
    + Description: URL mà Zalopay sẽ chuyển hướng người dùng sau khi quá trình liên kết hoàn tất.

    redirect_deep_link

    + DataType: string
    + Format: URL
    + Description: Deep link mà Zalopay sẽ chuyển hướng người dùng sau khi quá trình liên kết hoàn tất.

    callback_url

    + DataType: string
    + Format: URL
    + Description: Zalopay sẽ sử dụng URL này để thông báo khi thanh toán thành công. Nếu không được cung cấp, URL gọi lại mặc định của ứng dụng sẽ được sử dụng.

    embed_data

    + DataType: string
    + Format: JSON string
    + Description: Dữ liệu riêng của ứng dụng. Sử dụng "{}" nếu trống.

  • payment_data string required

    Dữ liệu thanh toán của ứng dụng. Sử dụng "{}" nếu trống.
    Chuỗi JSON bao gồm thông tin đặc biệt của thanh toán.
    Các trường đặc biệt của payment_data:
    amount

    + DataType: integer
    + Format: int64
    + Description: Số tiền thanh toán.

    description

    + DataType: string
    + Description: Mô tả thanh toán.

    callback_url

    + DataType: string
    + Format: URL
    + Description: Zalopay sẽ sử dụng URL này để thông báo khi thanh toán thành công. Nếu không được cung cấp, URL gọi lại mặc định của ứng dụng sẽ được sử dụng.

    embed_data

    + DataType: string
    + Format: JSON string
    + Description: Dữ liệu riêng của ứng dụng. Sử dụng "{}" nếu trống.

  • mac string required

    Đây là chữ ký của yêu cầu. 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 + | + identifier + | + binding_mode + | + binding_type + | + device_type + | + binding_data + | + payment_data + | + 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êm chi tiết.

Responses

OK

Schema
  • return_code integer

    Return codes:

    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_token string
  • binding_url string
  • reform_url string
Loading...