Tài liệu HDSD và tích hợp Tingee
  • I. Chung
    • 1.1. Lịch sử cập nhật
    • 1.2. Đăng ký tài khoản
    • 1.3. Tạo cửa hàng và liên kết tài khoản ngân hàng
      • 1.3.1. Liên kết ngân hàng tài khoản doanh nghiệp
    • 1.4. Tạo và tải QR Code ứng với tài khoản liên kết
    • 1.5. Thêm tài khoản nhân viên nhận thông báo
    • 1.6. 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. WEB Tingee cho khách hàng Đại lý
    • 3.1. Hướng dẫn sử dụng WEB Tingee
  • IV. APP Tingee cho Nhân viên
    • 4.1. Hướng dẫn sử dụng APP Tingee
  • V. APP Tingee Merchant cho Chủ kinh doanh
    • 5.1. Tải APP và Đăng ký
    • 5.2. Tạo mới cơ sở/cửa hàng và thêm liên kết ngân hàng
    • 5.3. Thêm mới tài khoản nhân viên nhận thông báo
    • 5.4. Các màn hình khác
    • 5.5. HDSD Tingee Box
  • VI. Tích hợp phần mềm
    • 6.1. Tích hợp Webhook
    • 6.2. API Liên kết ngân hàng
      • 6.2.1. API Thêm mới liên kết (VA)
      • 6.2.2. API xác thực OTP
    • 6.3. API Tạo mã QR Code
    • 6.4. API Tạo mã QR Code động
    • 6.5. API lấy danh sách tài khoản định danh (VA)
    • 6.6. Tích hợp hiển thị QR Code trên thiết bị Tingee 3L
    • 6.7. Tích hợp Tingee Payment Gateway cho WooCommerce
Powered by GitBook
On this page
  1. VI. Tích hợp phần mềm
  2. 6.2. API Liên kết ngân hàng

6.2.1. API Thêm mới liên kết (VA)

Api gửi thông tin liên kết ngân hàng

Previous6.2. API Liên kết ngân hàngNext6.2.2. API xác thực OTP

Last updated 2 months ago

API Thêm mới liên kết (VA)

POST - Môi trường live

POST - Môi trường test

Gửi lệnh thêm mới liên kết ngân hàng

Headers

Name
Type
Description

x-client-id

string

x-request-timestamp

string

Dấu thời gian (yyyyMMddHHmmssSSS)

x-signature

string

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}:{request 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 với Key là Secret token lấy tại mục Developers trên Tingee

Request Body

Name
Type
Description

accountType*

enum

Loại tài khoản (personal-account hoặc business-account)

bankName*

enum

Ngân hàng (OCB, MBB, BIDV, ACB, CTG, PGB, STB)

accountNumber*

string

Số tài khoản

accountName*

string

Tên chủ của tài khoản (không dấu) - Không gửi đi khi là tài khoản doanh nghiệp

subId*

string

Đầu định danh doanh nghiệp (Chỉ gửi đi khi liên kết tài khoản OCB doanh nghiệp)

identity*

string

Số CCCD/CMT/Hộ chiếu

mobile*

string

Số điện thoại

email*

string

Email (Chỉ bắt buộc với OCB)

merchantName*

string

Tên của merchant (không dấu)

merchantAddress*

string

Địa chỉ của merchant (không dấu)

{
    "code": "00",
    "message": "Success"
    "data": {"confirmId": "string"}
}
{
  "message": "Unauthorized.",
  "error": "Unauthorized",
  "statusCode": 401
}
{
  "message": "Not have access.",
  "error": "Bad Request",
  "statusCode": 400
}
{
  "message": "Forbidden.",
  "error": "Forbidden",
  "statusCode": 403
}
{
  "message": "Not Found.",
  "error": "Not Found",
  "statusCode": 404
}
{
  "message": "Internal Server Error.",
  "error": "Internal Server Error",
  "statusCode": 500
}
{
  "message": "Not Implemented.",
  "error": "Not Implemented",
  "statusCode": 501
}

Ví dụ CURL:

curl -X 'POST' \
  'https://uat-open-api.tingee.vn/v1/create-va' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-request-timestamp: 20240509154004003' \
--header 'x-client-id: 0fe48681158f17495ce4a5879188b81a' \
--header 'x-signature: 5a122a9cfce156b48a78d60138cc534f9b00c6abace7a05058b0158ebb9e6aa3485b65ddedeaa266db0c78d2b0cdf716c31f02c373331006745d814ae79dc8d7' \
  -d '{
  "accountType": "personal-account",
  "bankName": "OCB",
  "accountNumber": "string",
  "accountName": "string",
  "identity": "string",
  "mobile": "string",
  "email": "string",
  "merchantName": "string",
  "merchantAddress": "string"
}'

Định danh ứng dụng (Lấy trong )

https://open-api.tingee.vn/v1/create-va
https://uat-open-api.tingee.vn/v1/create-va
https://app.tingee.vn/m/developers
Page cover image