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

Thực hiện nạp tiền cho người dùng​

Thực hiện nạp tiền cho người dùng

Request Body required

Thực hiện nạp tiền cho người dùng

  • app_id int64 required

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

  • payment_id string required

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

  • partner_order_id string required

    Id duy nhất, được tạo trong hệ thống đối tác. Sử dụng để đối soát

  • m_u_id string required

    Danh tính của người dùng trong phản hồi của QueryUser API

  • amount int64 required

    Số tiền nạp vào ví của người nhận

  • description string required

    Thông tin mở rộng

  • partner_embed_data string required

    Thông tin cụ thể của đối tác, là một chuỗi JSON.

    Ví dụ: “{\“store_id\”:\“s2\”,\“store_name\”:\ “name\”}

  • reference_id string

    ID tham chiếu Zalopay được trả về trong phản hồi truy vấn thông tin người dùng

  • extra_info string required

    Sử dụng cho mục đích mở rộng, là một chuỗi JSON

  • time int64 required

    Thời điểm yêu cầu (timestamp) trong mili giây (ms)

  • sig string required

    Đó là chữ ký của giao dịch. Nó được tính bằng cách sử dụng thông tin đầu vào như sau: hmacinput = (app_id + “|” + payment_id + “|” + partner_order_id + “|” + m_u_id + “|” + amount + “|” + description + “|” + partner_embed_data + “|” + extra_info + “|” + time) sau đó sử dụng SHA256 với khóa HMAC của ứng dụng, sau đó RSA với khóa riêng tư của ứng dụng mà Zalopay cung cấp 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

    1 - SUCCESS

    2 - FAIL

  • return_message string

    Mô tả mã trả về

  • sub_return_code integer

    -68 - Đơn hàng đã tồn tại

    -101 - Tài khoản người nhận không tồn tại

    -401 - Tham số yêu cầu không hợp lệ

    -402 - Yêu cầu không được xác thực

    -406 - Tài khoản ví người nhận đạt đến giới hạn nạp tiền

    -500 - Hệ thống đang có lỗi. Vui lòng thử lại sau

    -503 - Hệ thống đang bảo trì, vui lòng quay lại sau

  • sub_return_message string

    Mô tả phụ của mã trả về

  • data object
  • order_id string

    Mã giao dịch của nhà cung cấp

  • status integer

    1 – SUCCESS

    2 – FAIL

    3 – PROCESSING: Phải lặp lại truy vấn trạng thái đơn hàng trong một khoảng thời gian cho đến khi nhận được trạng thái cuối cùng (khoảng thời gian và số lượng truy vấn được cấu hình trước)

    4 – PENDING: Các giao dịch đang chờ xử lý cần được sửa chữa thủ công bởi các nhóm nội bộ

  • m_u_id string

    Định danh của người dùng

  • phone string

    Số điện thoại của người dùng

  • amount int64

    Số tiền giao dịch

  • description string

    Mô tả giao dịch

  • partner_fee int64

    Phí của đối tác

  • zlp_fee int64

    Phí của Zalopay

  • extra_info string

    Thông tin bổ sung về đơn hàng, là một chuỗi JSON

  • time int64

    Thời điểm giao dịch (timestamp) tính bằng mili giây (ms)

  • upgrade_url string

    URL trang middle_page Zalopay để nâng cấp cho người dùng với giới hạn nạp tiền.

    Hiển thị khi nhận được return_code = 2 và sub_return_code = -406.

Loading...