Tài liệu HDSD và tích hợp Tingee
  • I. Chung
    • 1.1. Đăng ký tài khoản
    • 1.2. Tạo cửa hàng và liên kết tài khoản ngân hàng
      • 1.2.1. Liên kết ngân hàng tài khoản doanh nghiệp
    • 1.3. Tạo và tải QR Code ứng với tài khoản liên kết
    • 1.4. Thêm tài khoản nhân viên nhận thông báo
    • 1.5. Xem lịch sử giao dịch
  • II. Tích hợp trên các nền tảng thông báo biến động số dư
    • 2.1. Tích hợp Telegram
    • 2.2. Tích hợp Lark
    • 2.3. Tích hợp Zalo (Ngưng hỗ trợ)
  • III. APP Tingee cho Nhân viên
    • 3.1. Hướng dẫn sử dụng APP Tingee
  • IV. APP Tingee Merchant cho Chủ kinh doanh
    • 4.1. Tải APP và Đăng ký
    • 4.2. Tạo mới cơ sở/cửa hàng và thêm liên kết ngân hàng
    • 4.3. Thêm mới tài khoản nhân viên nhận thông báo
    • 4.4. Các màn hình khác
  • V. Tích hợp phần mềm
    • 5.1. Tích hợp Webhook
    • 5.2. API Liên kết ngân hàng
      • 5.2.1. API Thêm mới liên kết (VA)
      • 5.2.2. API xác thực OTP
    • 5.3. API Tạo mã QR Code
    • 5.4. API Tạo mã QR Code động
    • 5.5. API lấy danh sách tài khoản định danh (VA)
    • 5.6. Tích hợp hiển thị QR Code trên thiết bị Tingee 3L
    • 5.7. Tích hợp Tingee Payment Gateway cho WooCommerce
Powered by GitBook
On this page

5.1. Tích hợp Webhook

Tích hợp WebHooks để Tingee bắn thông tin giao dịch đến ứng dụng bán hàng của bạn. Mỗi khi phát sinh giao dịch, Tingee sẽ bắn WebHooks, ứng dụng bán hàng của bạn sẽ biết khách hàng đã thanh toán

Previous4.4. Các màn hình khácNext5.2. API Liên kết ngân hàng

Last updated 1 month ago

Tích hợp Webhook

Bước 1: Khách hàng đăng ký tài khoản Tingee tại app.tingee.vn, thêm cửa hàng và liên kết tài khoản ngân hàng cho cửa hàng (OCB, MBB, BIDV, VPB và ACB) - Chi tiết xem tại mục 1.1 và 1.2

Bước 2: Từ Trang chủ Tingee chọn Avatar -> Developers

Bước 3: Khách hàng dán URL Webhook cần nhận thông tin biến động số dư vào trường tương ứng sau đó chọn Lưu

Bước 4: Kiểm tra tính toàn vẹn dữ liệu từ Tingee gửi qua Webhook đã cập nhật như sau

  • Headers trả về có 2 thông số: x-signature và x-request-timestamp

Lưu ý: Ở một số ngôn ngữ 2 thông số x-signature và x-request-timestamp có thể bị convert thành tên khác. VD: Ở ngôn ngữ PHP 2 thông số đã bị biến đổi thành HTTP_X_SIGNATURE và HTTP_X_REQUEST_TIMESTAMP

  • Body trả về là 1 Object với nhiều trường thông tin:

{
  "clientId": string, //Id merchant
  "transactionCode": string, //Mã giao dịch
  "amount": number, //Số tiền
  "content": string, //Nội dung
  "bank": string, //Ngân hàng
  "accountNumber": string, //Số tài khoản
  "vaAccountNumber": string, //Số tài khoản VA(ảo)
  "transactionDate": string "yyyyMMddHHmmss" //Thời gian giao dịch
  "additionalData": list { name: string, value: string }[] //Thông tin còn lại trả về
}

  • Quy tắc kiểm tra tính toàn vẹn dữ liệu: Chuỗi giá trị cần hash = {x-request-timestamp}:{response body convert về string}

  • Sau đó thực hiện mã hóa chuỗi bên trên với giải thuật: HMAC SHA512, dùng Secret key là Secret token được tingee cung cấp sau khi có tài khoản trên Tingee.

  • Chuỗi mã hóa được sinh nếu giống thông số x-signature thì được coi là hợp lệ

  • Sau khi ứng dụng đối tác xử lý kết quả thì trả về response cho tingee như sau:

{
code: string,
message: string
}

  • Với code = '00' - Thành công

  • Hoặc code = '02' - Giao dịch đã được cập nhật thành công

  • Hoặc code = '09' - Chữ ký không hợp lệ

  • Hoặc code = 'xx' (mã lỗi khác)

Lưu ý: Trả về khác 00 hoặc 02 sẽ retry 5 lần mỗi lần 5 phút

Page cover image