Đối soát Ví điện tử VinID Pay
Cung cấp các thông tin trao đổi, quy trình đối soát, quy trình xử lý sai sót.
1. Các quy định chung
Với trường hợp đối tác gửi dữ liệu dùng để đối soát thì các case trả lời dùng dữ liệu đối tác để trả lời, trừ case dữ liệu chỉ có ở VinID.
Quy định chỉ trả lời các giao dịch sai lệch khi trả lời kết quả đối soát. Các trường hợp trả lời tất cả các loại giao dịch thì sẽ note riêng sau.
2. Quy trình đối soát
2.1. VinID gửi dữ liệu đối soát
Mô tả quy trình :
Bước 1: Hàng ngày Vinid thực hiện xuất dữ liệu giao dịch của ngày hôm trước ra file CSV để upload lên server sFTP cho đối tác.
Bước 2: Đối tác kết nối vào server sFTP của Vinid để lấy file giao dịch.
Bước 3: Đối tác thực hiện đối soát và xuất kết quả đối soát ra file CSV sau đó upload lên server sFTP.
Bước 4: Nghiệp vu của đối tác phối hợp cùng nghiệp vụ của Vinid xử lý các giao dịch sai lệch (nếu có).
Bước 5: Hệ thống đối soát của Vinid thực hiện lấy file kết quả đối soát trên sFTP do đối tác gửi để cập nhật vào hệ thống.
Bước 6: Nghiệp vụ của Vinid thực hiện kiểm tra kết quả đối soát và phối hợp cùng nghiệp vụ của đối tác xử lý các giao dịch (nếu có).
Bước 7: Kết thúc.
2.2. Đối tác gửi dữ liệu đối soát
Mô tả quy trình :
Bước 1: Hàng ngày đối tác thực hiện xuất danh sách giao dịch của ngày trước đó ra file và upload lên server sFTP của VinID.
Bước 2: VinID thực hiện lấy file giao dịch do đối tác cung cấp sau đó import vào hệ thống
Bước 3: Hệ thống đối soát của V thực hiện đối soát, cập nhật kết quả đối soát vào cơ sở dữ liệu sau đó xuất file kết quả đối soát để upload lên server sFTP cho đối tác.
Bước 4: Đối tác thực hiện lấy file kết quả đối soát sử server sFTP và cập nhật kết quả vào hệ thống của đối tác.
Bước 5: Nghiệp vụ của đối tác kiểm tra kết quả đối soát sau đó kết hợp cùng nghiệp vụ của Vinid xử lý các giao dịch sai lệch (nếu có).
Bước 6: Nghiệp vụ của Vinid thực hiện kiểm tra kết quả đối soát sau đó kết hợp cùng nghiệp vụ đối tác xử lý các giao dịch sai lệch (nếu có).
Bước 7: Kết thúc.
3. Xử lý khi có sai lệch
3.1. VinID có giao dịch thành công, đối tác ghi nhận không thành công
Cách 1: Nhân viên đối soát thực hiện: Hoàn tiền vào ví cho khách hàng.
Cách 2: Thực hiện ghi nhận thành công bổ sung ở dịch vụ: áp dụng ở bill gạch nợ bổ sung cước cho khách hàng, mua hàng thì thực hiện giao hàng cho khách hàng.
3.2. Đối tác có giao dịch thành công, VinID ghi nhận không thành công
Cách 1: Thực hiện truy thu tiền của khách hàng tại ví khi 2 bên đồng ý gạch nợ hóa đơn của khách hàng.
Cách 2: Hủy giao dịch phía đối tác: áp dụng ở bill hủy gạch nợ ở đối tác.
3.3. Sai lệch số tiền, sai lệch thông tin
Vận hành 2 bên phối hợp để xử lý trường hợp này.
4. Thông tin trường dữ liệu giữa đối tác và VinID
Định dạng file đối tác gửi : YYYYMMDD_Đối_tác_VINID_TRAN.csv
Định dạng file giao dịch VinID gửi đối tác: YYYYMMDD_VINID_Đối_tác_TRAN.csv
Định dạng file dữ liệu kết quả đối soát VinID gửi: YYYYMMDD_VINID_Đối_tác_RESULT_TRAN.csv
4.1. File đối tác gửi VinID
STT | Tên trường | Yêu cầu | Dữ liệu | Mô tả |
1 | ID | Mandatory | String(50) | ID tại đối tác |
2 | Mã hóa đơn | Mandatory | String(50) | Mã hóa đơn gửi khi thanh toán |
3 | Mã giao dịch tại ví | Mandatory | String(30) | Thông tin ví trả khi thanh toán |
4 | Số tiền | Mandatory | Number | Số tiền giao |
5 | Tiền tệ | Mandatory | String(10) | VND |
6 | Phí | Mandatory | Number | Tiền phí giao dịch khách hàng phải thanh toán |
7 | Thuế | Mandatory | Number | Tiền thuế giao dịch khách hàng phải thanh toán |
8 | Chiết khấu | Mandatory | Number | Chiết khấu cho khách hàng |
9 | Mã merchant | Optional | String(50) | Mã merchant truyền khi giao dịch |
10 | Mã MID | Optional | String(15) | Mã MID truyền khi giao dịch |
11 | Mã TID | Optional | String(16) | Mã TID truyền khi giao dịch |
12 | Ngày giao dịch | Mandatory | String(10) | DD/MM/YYYY |
13 | Thời gian giao dịch | Optonal | String(8) | H24:mi:ss |
14 | Trạng thái giao dịch đối tác | Mandatory | Number | 0: Thành công 1: Pending/processing 2: Thất bại |
15 | Mô tả giao dịch | Optional | String(1000) | Các thông tin liên quan đến đối soát, gửi dạng json |
16 | Loại giao dịch | Mandatory | String(10) | 1: Giao dịch thanh toán -1: Giao dịch hòan tiền |
17 | Check sum | Mandatory | String | md5(dòng dữ liệu + private key) |
4.2. File VinID gửi đối tác
STT | Tên trường | Yêu cầu | Dữ liệu | Mô tả |
1 | Mã hóa đơn | Mandatory | String(50) | Mã hóa đơn khi gửi thanh toán |
2 | Mã giao dịch tại ví | Mandatory | String(30) | Thông tin ví trả khi thanh toán |
3 | Số tiền | Mandatory | Number | Số tiền giao |
4 | Tiền tệ | Mandatory | String(10) | VND, POINT |
5 | Phí | Mandatory | Number | Tiền phí giao dịch khách hàng phải thanh toán |
6 | Thuế | Mandatory | Number | Tiền thuế giao dịch khách hàng phải thanh toán |
7 | Chiết khấu | Mandatory | Number | Chiết khấu cho khách hàng |
8 | Mã merchant | Optional | String(50) | Mã merchant truyền khi giao dịch |
9 | Mã MID | Optional | String(15) | Mã MID truyền khi giao dịch |
10 | Mã TID | Optional | String(16) | Mã TID truyền khi giao dịch |
11 | Ngày giao dịch | Mandatory | String(10) | DD/MM/YYYY |
12 | Thời gian giao dịch | Optonal | String(8) | H24:mi:ss |
13 | Mô tả giao dịch | Optional | String(1000) | Mô tả |
14 | Mã giao dịch tại VinID | Mandatory | String(20) | Mã giao dịch tại VinID |
15 | Trạng thái tại VinID | Mandatory | Number | 0: Thành công 1: Hold tiền khách hàng -1: Thất bại |
16 | Loại giao dịch | Optional | String(10) | 1: Thanh toán -1: Refund |
17 | Check sum | Mandatory | String | md5(dòng dữ liệu + private key) |
4.3. File kết qủa đối soát VinID gửi đối tác
STT | Tên trường | Yêu cầu | Dữ liệu | Mô tả |
1 | ID | Mandatory | String(50) | ID tại đối tác |
2 | Mã hóa đơn | Optional | String(50) | Mã hóa đơn gửi khi thanh toán |
3 | Mã giao dịch tại ví | Mandatory | String(30) | Thông tin ví trả khi thanh toán |
4 | Số tiền | Mandatory | Number | Số tiền giao |
5 | Tiền tệ | Mandatory | String(10) | VND, POINT |
6 | Phí | Mandatory | Number | Tiền phí giao dịch khách hàng phải thanh toán |
7 | Thuế | Mandatory | Number | Tiền thuế giao dịch khách hàng phải thanh toán |
8 | Chiết khấu | Mandatory | Number | Chiết khấu cho khách hàng |
9 | Mã merchant | Optional | String(50) | Mã merchant truyền khi giao dịch |
10 | Mã MID | Optional | String(15) | Mã MID truyền khi giao dịch |
11 | Mã TID | Optional | String(16) | Mã TID truyền khi giao dịch |
12 | Ngày giao dịch | Mandatory | String(10) | DD/MM/YYYY |
13 | Thời gian giao dịch | Optonal | String(8) | H24:mi:ss |
14 | Trạng thái giao dịch đối tác | Mandatory | Number | 0: Thành công 1: Pending/processing 2: Thất bại |
15 | Mô tả giao dịch | Optional | String(1000) | Các thông tin liên quan đến đối soát, gửi dạng json |
16 | Mã giao dịch tại VinID | Mandatory | String(20) | Mã giao dịch tại VinID |
17 | Trạng thái tại VinID | Mandatory | Number | 0: Thành công 1: Hold tiền khách hàng -1: Thất bại |
18 | Loại giao dịch | Mandatory | String(10) | 1: Giao dịch thanh toán -1: Giao dịch hòan tiền |
19 | Trạng thái đối soát | Mandatory | String(2) | 00: Giao dịch khớp 2 bên 01: VinID thành công, đối tác không thành công 02: VinID không thành công, đối tác thành công 03: Thông tin sai lệch (do sai lệch số tiền, thông tin khách hàng, ...) |
20 | Check sum | Mandatory | String | md5(dòng dữ liệu + private key) |
Last updated
