Page cover

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

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

POST https://open-api.tingee.vn/v1/create-va - Môi trường live

POST https://uat-open-api.tingee.vn/v1/create-va - 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

Định danh ứng dụng (Lấy trong https://app.tingee.vn/m/developers)

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 (Vietinbank), PGB, STB, VPB. Riêng với VCB sẽ liên kết trên app Tingee Merchant

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 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)

Ví dụ CURL:

Last updated