Skip to main content

📝 API Update – Tích hợp BaoKim & Cập nhật tham số Chi hộ

Bản cập nhật này mang đến thông tin tích hợp ví điện tử BaoKim vào dịch vụ Chi hộ, đồng thời chuẩn hóa tham số phân loại tài khoản nhận tiền trên hệ thống API.

🚀 Tích hợp BaoKim (Chi hộ Direct Link)​

Hệ thống Tingee chính thức hỗ trợ tích hợp ví điện tử BaoKim. Đối tác có thể thực hiện Đồng bộ ví để phục vụ các nghiệp vụ Thu hộ và Chi hộ.

  • Mã BIN định danh: BAOKIM
  • Các luồng API hỗ trợ:
    • Tạo lệnh Chi hộ (Chỉ hỗ trợ giao dịch Chi đơn, hiện đã loại bỏ Chi lô)
    • Truy vấn thông tin người hưởng (Account Inquiry)
    • Truy vấn trạng thái giao dịch (Transaction Inquiry)
    • Tích hợp tài khoản ví (Đồng bộ ví với mã định danh BAOKIM)
    • Các API trong nhóm Ngân hàng & Định danh

👉 Tham khảo: Khởi tạo lệnh chi hộ (VietinBank, BaoKim)

🔄 Chuẩn hóa tham số Chi hộ (creditAccountType)​

Nhằm đồng bộ cấu trúc dữ liệu thanh toán và hỗ trợ định tuyến tới đa dạng các đối tác như BaoKim, BIDV, chúng tôi tiến hành chuẩn hóa tham số loại tài khoản trên API Khởi tạo lệnh chi hộ.

Thay đổi trên API /v1/direct-link/create-transfer:

  • Thay thế trường: paymentMethod (to-acc, to-id) đã được loại bỏ và thay thế hoàn toàn bằng trường creditAccountType.
  • Cơ chế hoạt động: creditAccountType hỗ trợ thiết lập ở cả Cấp độ chung (Global Parameter) và Cấp độ chi tiết (Record-level).
  • Các giá trị hỗ trợ mới:
    • ACCOUNT: Chuyển qua số Tài khoản
    • CARD: Chuyển qua số Thẻ
    • WALLET: Chuyển qua Ví điện tử
    • ID: Chuyển qua Giấy tờ tùy thân (CMND/CCCD/Hộ chiếu)

Việc chuẩn hóa này đem lại cấu trúc Payload nhất quán và khả năng mở rộng tốt hơn cho các kênh thanh toán trong tương lai.