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

Truy vấn trạng thái đơn hàng​

Khi user thanh toán thành công, Zalopay sẽ gọi callback (IPN) tới merchant để merchant cập nhật trạng thái đơn hàng Thành công trên hệ thống.
Trong thực tế callback có thể bị miss do lỗi Network Timeout / Merchant Service Unavailable / Internal Error,... nên Merchant cần thực hiện việc chủ động gọi API truy vấn trạng thái đơn hàng.
Các thời điểm gọi truy vấn trạng thái đơn hàng:
- Có cron job / schedule để định kỳ gọi truy vấn trạng thái đơn hàng cho đến khi nhận callback hoặc hết 15 phút (mặc định thời gian hết hạn của đơn hàng) kể từ lúc đơn hàng tạo ra.
- Gọi 1 lần sau 15 phút (mặc định thời gian hết hạn của đơn hàng) kể từ lúc tạo đơn hàng và không nhận được callback.

Request Body required
  • app_id integer 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.

  • app_trans_id string required

    Mã giao dịch Merchant gửi qua hệ thống Zalopay để user thực hiện thanh toán (TXID của giao dịch đơn hàng).

  • 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.
    - hmacinput = app_id + | + app_trans_id + | + mac key
    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

    Mô tả mã trạng thái chi tiết.

  • is_processing boolean

    Thông tin trạng thái xử lý của đơn hàng (dành riêng cho Zalopay).

  • amount int64

    Số tiền thanh toán.

  • zp_trans_id int64

    Mã giao dịch của Zalopay. Merchant dùng giá trị này để yêu cầu hoàn tiền và đối soát.

  • server_time long

    Thời gian xử lý của hệ thống Zalopay (unix timestamp in milliseconds).

  • discount_amount long

    Số tiền user được hưởng khuyến mãi.

Loading...