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 giao dịch Zalopay gọi về cho ứng dụng

    data là 1 Json String có các trường sau:

    app_id (int): app_id của đơn hàng
    app_trans_id (string): app_trans_id của đơn hàng. Ví dụ: 180208181007242
    app_time (long): app_time của đơn hàng. Ví dụ: 1460543835849
    app_user (string): app_user của đơn hàng
    amount (long): Số tiền ứng dụng nhận được (VND)
    embed_data (json string): embed_data của đơn hàng. Dùng "{}" nếu rỗng. Ví dụ: {"promotioninfo":"","merchantinfo":"du lieu rieng cua ung dung"}

    item (json array string): item của đơn hàng. Dùng "{}" nếu rỗng. Ví dụ: [{"itemid":"knb","itename":"kim nguyen bao","itemprice":198400,"itemquantity":1}]
    zp_trans_id (long): Mã giao dịch của Zalopay. Ví dụ: 160413000003083
    server_time (long): Thời gian giao dịch của Zalopay (unix timestamp in miliseconds). Ví dụ: 1460543836370
    channel (int): Kênh thanh toán. Ví dụ: 38
    merchant_user_id (string): Zalopay user đã thanh toán cho đơn hàng. Ví dụ: 7ZMSl3nEg5sOUJzOLSoUFT8xKNQVaLOLXHB--8Eytqc
    user_fee_amount (long): Số tiền phí (VND).
    discount_amount (long): Số tiền giảm giá (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 của đơn hàng, dùng Callback Key (Key2) được cung cấp để chứng thực đơn hàng.

  • type int

    Loại callback
    1: Order
    2: Agreement

Responses

OK

Schema
  • return_code int

    1: thành công
    2: trùng mã giao dịch Zalopay zptransid hoặc app_trans_id ( đã cung cấp dịch vụ cho user trước đó)
    mã lỗi khác: thất bại (không callback lại)

  • return_message string

    Details of the status code

Loading...