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

Callback​

API đối tác xây dựng sẽ nhận kết quả thanh toán từ Zalopay. Khi và chỉ khi Zalopay đã thu tiền khách hàng thành công thì mới gọi API này để thông báo kết quả.

Request Body required
  • data string

    Dữ liệu callback (IPN) Zalopay gửi về cho merchant sau khi thu tiền khách hàng thành công.

    data là một JSON String có các trường sau:
    - app_id (int): Thông tin app_id của đơn hàng.
    - app_trans_id (string): Thông tin app_trans_id của đơn hàng.
    - app_time (long): Thông tin app_time của đơn hàng.
    - app_user (string): Thông tin app_user của đơn hàng.
    - amount (long): Thông tin số tiền user thực hiện thanh toán(VND)
    - embed_data (JSON string): Thông tin embed_data của đơn hàng.
    - item (JSON array string): Thông tin item của đơn hàng
    - zp_trans_id (long): Thông tin mã giao dịch của Zalopay.
    - server_time (long): Thời gian giao dịch của Zalopay (unix timestamp in miliseconds).
    - channel (int): Kênh thanh toán.
    - merchant_user_id (string): Thông tin định danh của Zalopay user tương ứng với app_id.
    - user_fee_amount (long): Thông tin phí của đơn hàng(VND).
    - discount_amount (long): Thông tin khuyến mãi của đơn hàng (VND).

    Ví dụ:

    {"data":"{\"app_id\":2553,\"app_trans_id\":\"200904_2553_1598435687208\",\"app_time\":1599189392817,\"app_user\":\"demo\",\"amount\":10000,\"embed_data\":\"{\\\"merchantinfo\\\":\\\"embeddata123\\\",\\\"promotioninfo\\\":\\\"\\\"}\",\"item\":\"[{\\\"itemid\\\":\\\"knb\\\",\\\"itemname\\\":\\\"kim nguyen bao\\\",\\\"itemprice\\\":198400,\\\"itemquantity\\\":1}]\",\"zp_trans_id\":200904000000389,\"server_time\":1599189413498,\"channel\":38,\"merchant_user_id\":\"7ZMSl3nEg5sOUJzOLSoUFT8xKNQVaLOLXHB--8Eytqc\",\"user_fee_amount\":0,\"discount_amount\":0}","mac":"d8d33baf449b31d7f9b94fa50d7c942c08cd4d83f28fa185557da21acb104f67","type":1}
  • mac string

    Thông tin chứng thực data callbak (IPN) từ Zalopay về cho merchant, mac = HMAC(hmac_algorihtm, callback 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.
    - callback key: được cung cấp bởi Zalopay.
    - hmac_input = data.

  • type int

    Loại callback
    1: Order
    2: Agreement

Responses

OK

Schema
  • return_code int

    1: Dữ liệu callback hợp lệ.
    2: Dữ liệu callback không hợp lệ.

  • return_message string

    Thành công: Tương ứng với return_code=1.
    Thất bại: Tương ứng với return_code=2.

Loading...