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

Chi hộ tất cả trong một

Tổng quan​

Bạn là một doanh nghiệp năng động đang tìm kiếm một giải pháp thuận tiện và nhanh chóng để dễ dàng chi trả tiền cho đội ngũ lao động hoặc đối tác kinh doanh của bạn? Tính năng Chi Hộ Tất Cả Trong Một của chúng tôi được thiết kế đặc biệt để đáp ứng chính xác những nhu cầu của bạn, với các đặc điểm nổi bật:

Chuyển tiền thuận lợi, nhanh chóng và dễ dàng qua các nền tảng: Trải nghiệm sự thuận tiện khi chuyển tiền một cách dễ dàng từ Ví Doanh Nghiệp của bạn đến bất kỳ Ví Zalopay, Tài Khoản Ngân Hàng hoặc Thẻ ATM nào. Tính năng Chi Hộ Tất Cả Trong Một của chúng tôi loại bỏ sự phiền toái khi phải đối mặt với các kênh thanh toán khác nhau - đó là một điểm đến duy nhất cho các giao dịch nhanh chóng.
Đơn giản hóa với quy trình chi trả: Không còn mất thời gian với các thủ tục thanh toán phức tạp. Tính năng Chi Hộ Tất Cả Trong Một tự động hóa quá trình chuyển tiền, giảm thiểu sai sót và tối ưu hóa thời gian quản lý giao dịch tài chính của bạn.
Tính bảo mật cao: Chúng tôi ưu tiên đến sự an toàn các giao dịch chuyển tiền của bạn. Tính năng Chi Hộ Tất Cả Trong Một được xây dựng bằng các biện pháp bảo mật hiện đại nhất, đảm bảo rằng thông tin và giao dịch của bạn luôn được bảo vệ một cách an toàn.
Theo dõi và báo cáo chi tiêu: Theo dõi lịch sử chi tiêu và tạo báo cáo một cách dễ dàng để bạn có cái nhìn tổng quan về tình hình tài chính.
Hỗ trợ đa nền tảng: Khám phá tính năng Chi Hộ Tất Cả Trong Một trên nhiều nền tảng, từ ứng dụng di động đến trang web, để bạn có thể tiếp cận và quản lý tài chính mọi nơi, mọi lúc.
Dễ dàng, linh hoạt, và an toàn - tính năng Chi Hộ Tất cả Trong Một từ Ví Doanh Nghiệp là cầu nối hoàn hảo giữa doanh nghiệp của bạn và việc quản lý tài chính một cách hiệu quả. Bắt đầu trải nghiệm ngay hôm nay và cảm nhận sự thuận lợi mà nó mang lại.
Trong các phần tiếp theo, chúng tôi sẽ hướng dẫn bạn từng bước để tích hợp Chi hộ tất cả trong một của Zalopay.

Tiền điều kiện​

Trước khi bạn bắt đầu, hãy đảm bảo các công việc sau được thực hiện để tích hợp suôn sẻ:

  • Đã đăng ký tài khoản merchant thành công và có được app_id, mac_key, private_key từ Merchant Portal.
  • Hiểu cách sử dụng và đặc điểm kỹ thuật của các API sau:

           Verify Account API
           Transfer Fund API
           Query Transaction API
           Balance API
           Get Bank Code List API

Cách hoạt động​

Luồng hoạt động chi tiết như sau

Payment flow

Tích hợp​

Phần này tập trung vào cách tích hợp luồng Chi hộ tất cả trong một từ Zalopay. Quy trình tích hợp bao gồm các bước sau:

      1. Sử dụng API Balance để truy xuất số dư tài khoản Ví doanh nghiệp
      2. Sử dụng API Verify Account và Get Bank Code List để kiểm tra tài khoản người dùng nhận tiền.
      3. Sử dụng API Transfer Fund để tạo yêu cầu chuyển tiền từ Ví doanh nghiệp đến tài khoản người dùng.
      4. Sử dụng API Query Transaction để kiểm tra trạng thái chuyển tiền.

Bước 1. Truy xuất số dư tài khoản Ví doanh nghiệp​

Từ máy chủ của Doanh nghiệp, gọi API Balance, tham khảo API Explore để biết chi tiết các tham số
Đây là một ví dụ về yêu cầu (request) truy vấn số dư tài khoản Ví doanh nghiệp và phản hồi (response) nhận về:

Yêu cầu (request) truy vấn số dư tài khoản ví doanh nghiệpPhản hồi (response) nhận về
{
      "app_id": 15752,
      "payment_id": "P270868",
      "time": "3729797766",
      "partner_embed_data": "{\"merchant_wallet_id\":\"336A321832\"}",
      "mac": "string"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "balance": 42712
      }
}

Bước 2. Kiểm tra tài khoản người dùng nhận tiền​

Từ máy chủ của Doanh nghiệp, gọi API Verify Account, tham khảo API Explore để biết chi tiết các tham số.
Người dùng nhận tiền từ Ví doanh nghiệp, thông qua 3 loại tài khoản khác nhau:

  • Tài khoản Zalopay
  • Tài khoản Ngân hàng
  • Thẻ ATM

Đây là một ví dụ về yêu cầu (request) kiểm tra tài khoản người dùng nhận tiền và phản hồi (response) nhận về:

Phân loạiYêu cầu (request) kiểm tra tài khoảnPhản hồi (response) nhận về
Tài khoản Zalopay{
      "app_id": 15752,
      "disbursement_type": "WALLET",
      "receiver_info": "HHDOHu0caM7+hwCkQgVYSpAJ+ZSHf6ffDBuJLEcvQ...",
      "amount": 10000,
      "redirect_url": "zalopay://launch/app/2242",
      "time": 1700551306699,
      "mac": "5ad0de3161a45701896ca9f75ecc088291e58701e19..."
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "m_u_id": "Yh2mBCG983efb1Iwu4FuZJO5TgpnCXT-4fwvhNJV1a8"
      }
}
Tài khoản Ngân hàng{
      "app_id": 15752,
      "disbursement_type": "BANK",
      "receiver_info": "P2v4OjlUaModdNXXYuqawuzgxzvAhtIRei485ubTj/PjbPNMLk9M5VpFnp7....",
      "amount": 10000,
      "time": 1700554407764,
      "mac": "ff65866734d50ac742ec473bad50e8283fcfcc4891..."
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "account_holder_name": "NGUYEN VAN A"
      }
}
Thẻ ATM{
      "app_id": 15752,
      "disbursement_type": "BANK",
      "receiver_info": "mUcjpp6+M44BFdqmwa3GfpikWq8mV/24I....",
      "amount": 10000,
      "redirect_url": "zalopay://launch/app/2242",
      "time": 1700554120519,
      "mac": "3ec51c79bdf499a1833c3c831cb8e73bf84fff19637...."
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "card_holder_name": "NGUYEN VAN A"
      }
}

Bước 3. Tạo yêu cầu chuyển tiền từ Ví doanh nghiệp vào tài khoản người dùng nhận tiền​

Từ máy chủ của Doanh nghiệp, gọi API Tranfer Fund, tham khảo API Explore để biết chi tiết các tham số.
Người dùng nhận tiền từ Ví doanh nghiệp, thông qua 3 loại tài khoản khác nhau:

  • Tài khoản Zalopay
  • Tài khoản Ngân hàng
  • Thẻ ATM

Đây là một ví dụ về yêu cầu (request) chuyển tiền vào tài khoản người dùng nhận tiền và phản hồi (response) nhận về:

Phân loạiYêu cầu (request) chuyển tiềnPhản hồi (response) nhận về
Chuyển tiền vào Tài khoản Zalopay{
      "app_id": 15752,
      "payment_id": "P270868",
      "partner_order_id": "231010_6006493217",
      "disbursement_type": "WALLET",
      "receiver_info": "EKDa5iB2QvDMOOAlwqDXRZDTR+B3y....",
      "amount": 10000,
      "description": "Bonuses for users",
      "partner_embed_data": "",
      "extra_info": "",
      "time": 1700634330810,
      "mac": "e299e9189904266571daa7011d1746bd6d0082c8e1fccc3b07d203d3b9103585",
      "mc_reference_id": "TRANSACTION_01"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "order_id": "51642840027000060",
           "disbursement_type": "WALLET",
           "m_u_id": "Yh2mBCG983efb1Iwu4FuZJO5TgpnCXT-4fwvhNJV1a8",
           "phone": "*******9047",
           "status": 3,
           "amount": 10000,
           "partner_fee": 0,
           "zlp_fee": 0,
           "server_time": 1700634331351
      }
}
Chuyển tiền vào Tài khoản Ngân hàng{
      "app_id": 15752,
      "payment_id": "P270868",
      "partner_order_id": "3315712257",
      "disbursement_type": "BANK",
      "receiver_info": "Y8Dmn8sD8b56oB0BvURcj.....",
      "amount": 10000,
      "description": "Bonuses for users",
      "partner_embed_data": "",
      "extra_info": "",
      "time": 1700634596747,
      "mac": "fb3a2232210d2dfa12692ed15ff57eeee6db525e367f2f808e6797f516058c9c",
      "mc_reference_id": "TRANSACTION_01"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "order_id": "51643288515559318",
           "disbursement_type": "BANK",
           "bank_code": "ZPBIDV",
           "account_no": "*******2222",
           "account_holder_name": "NGUYEN VAN A",
           "status": 3,
           "amount": 10000,
           "partner_fee": 0,
           "zlp_fee": 0,
           "server_time": 1700634598672
      }
}
Chuyển tiền vào Thẻ ATM{
      "app_id": 15752,
      "payment_id": "P270868",
      "partner_order_id": "3729797766",
      "disbursement_type": "BANK",
      "receiver_info": "IhtaVoGt19bRqU8vzinEwfy....",
      "amount": 10000,
      "description": "Bonuses for users",
      "partner_embed_data": "",
      "extra_info": "",
      "time": 1700635341572,
      "mac": "76a9ef49f7b334b9957962c04e41cb16b33623ce8e457b193d30c69ae45e2044",
      "mc_reference_id": "TRANSACTION_01"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "order_id": "51644538015498134",
           "disbursement_type": "BANK",
           "bank_code": "ZPCTG",
           "card_no": "***********6789",
           "card_holder_name": "NGUYEN VAN A",
           "status": 3,
           "amount": 10000,
           "partner_fee": 0,
           "zlp_fee": 0,
           "server_time": 1700635343439
      }
}

Bước 4. Kiểm tra trạng thái giao dịch chuyển tiền​

Từ máy chủ của Doanh nghiệp, gọi API Query Transaction, tham khảo API Explore để biết chi tiết các tham số.
Đây là một ví dụ về yêu cầu (request) kiểm tra trạng thái giao dịch tiền và phản hồi (response) nhận về:

Phân loạiYêu cầu (request) chuyển tiềnPhản hồi (response) nhận về
Chuyển tiền vào Tài khoản Zalopay{
      "app_id": 15752,
      "partner_order_id": "1613909272",
      "time": 1701241387331,
      "mac": "5651d35fc58bf276a522262b76637fb9f1dad485014d14c4179227bafab968b4"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "order_id": "51642840027000060",
           "disbursement_type": "WALLET",
           "m_u_id": "Yh2mBCG983efb1Iwu4FuZJO5TgpnCXT-4fwvhNJV1a8",
           "phone": "*******9047",
           "status": 3,
           "amount": 10000,
           "partner_fee": 0,
           "zlp_fee": 0,
           "server_time": 1700634331351
      }
}
Chuyển tiền vào Tài khoản Ngân hàng{
      "app_id": 15752,
      "partner_order_id": "1613909272",
      "time": 1701241387331,
      "mac": "5651d35fc58bf276a522262b76637fb9f1dad485014d14c4179227bafab968b4"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "order_id": "51643288515559318",
           "disbursement_type": "BANK",
           "bank_code": "ZPBIDV",
           "account_no": "*******2222",
           "account_holder_name": "NGUYEN VAN A",
           "status": 3,
           "amount": 10000,
           "partner_fee": 0,
           "zlp_fee": 0,
           "server_time": 1700634598672
      }
}
Chuyển tiền vào Thẻ ATM{
      "app_id": 15752,
      "partner_order_id": "1613909272",
      "time": 1701241387331,
      "mac": "5651d35fc58bf276a522262b76637fb9f1dad485014d14c4179227bafab968b4"
}		{
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "data": {
           "order_id": "51644538015498134",
           "disbursement_type": "BANK",
           "bank_code": "ZPCTG",
           "card_no": "***********6789",
           "card_holder_name": "NGUYEN VAN A",
           "status": 3,
           "amount": 10000,
           "partner_fee": 0,
           "zlp_fee": 0,
           "server_time": 1700635343439
      }
}