nghiỆp vỤ kẾt nỐi vÍ ĐiỆn t mb
TRANSCRIPT
NGHIỆP VỤ KẾT NỐI VIacute ĐIỆN TỬ MB
MỤC LỤC
1 ĐĂNG KYacute MỞ TAgraveI KHOẢN ĐIỆN TỬ 3
a Mocirc tả chung 3
b Luồng quy trigravenh nghiệp vụ 3
c Luồng quy trigravenh tiacutech hợp 10
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ 16
a Mocirc tả chung 16
b Luồng quy trigravenh nghiệp vụ 16
c Luồng quy trigravenh tiacutech hợp 19
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT 23
a Mocirc tả chung 23
b Luồng quy trigravenh nghiệp vụ 23
c Luồng quy trigravenh tiacutech hợp 27
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT 30
a Mocirc tả chung 30
b Luồng quy trigravenh nghiệp vụ 30
c Luồng quy trigravenh tiacutech hợp 34
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB 37
a Mocirc tả chung 37
b Luồng quy trigravenh nghiệp vụ 38
c Luồng quy trigravenh tiacutech hợp 39
6 THANH TOAacuteN DỊCH VỤ 41
a Mocirc tả chung 41
b Luồng quy trigravenh nghiệp vụ 42
c Luồng quy trigravenh tiacutech hợp 43
1 ĐĂNG KYacute MỞ TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Đối với khaacutech hagraveng mới Cho pheacutep mở một tagravei khoản viacute điện tện tử của khaacutech hagraveng vagrave gắn
với kecircnh thực hiện từ đối taacutec
- Đối với khaacutech hagraveng đatilde tồn tại trecircn hệ thống MB Cho pheacutep gắn tagravei khoản thanh toaacuten đatilde tồn
tại trecircn hệ thống MB với thocircng tin điện tử của khaacutech hagraveng
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ quy trigravenh nghiệp vụ
LUỒNG QUY TRIgraveNH TẠO TAgraveI KHOẢN THANH TOAacuteN MBBANK
KHAacuteCH HAgraveNG ĐỐI TAacuteC GATEWAY MB T24
Ph
ase
Đăng nhập
1 Lựa chọn tiacutenh
năng Đăng kyacute tagravei
khoản
2 Nhập thocircng tin
giấy tờ tugravey thacircn
32Yecircu cầu eKYC4 Thực hiện eKYC
5 Thocircng tin
eKYC coacute hợp lệ
khocircng
82 Kiểm tra KH
đatilde coacute CODE tại
MB chưa
10 Kiếm tra KH
đatilde coacute tk MB
chưa
12 Gửi OTP cho
KH13 Nhập OTP
OTP coacute hợp lệ14 Tạo Code vagrave TK
mới cho KH
NO
11 Gửi yecircu cầu tạo
tk vagrave code mới cho
KH
17 Phản hồi kết quả
15 Lưu WALET ID
gắn với tagravei khoản
của KH 16 Lưu lại thocircng tin
token ID gắn với
user
18 Thocircng baacuteo kết
quả cho khaacutech hagravengEND NO
6 Kiểm tra xem
khaacutech hagraveng đatilde coacute
wallet ID hay
chưa
61 Gửi thocircng tin
WALLET ID
62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho KH
63 Nhận thocircng tin
tagravei khoản viacute vagrave kết
thuacutec
7 Gửi thocircng tin
khaacutech hagraveng chưa coacute
wallet ID
YES
9 Kiếm tra số
điện thoại KH
đăng kyacute coacute khớp
với SDT DNP
gửi hay khocircng
NO52Trả thocircng baacuteo lỗi
cho khaacutech hagraveng
YES
NO
3Kiểm tra
khaacutech hagraveng đatilde
coacute WALLET ID
hay chưa
YES
31 Hiển thị thocircng
tin khaacutech hagraveng đatilde
tồn tại WALLET ID
NO
51 Gửi thocircng tin
CMND vagrave SDT cho
MB
NO
YES
NO
8 Mở WALLETID
81 Gửi lại WALLET
ID số CMND vagrave
SDT
YES
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN Diễn giải
Bước 1 Đăng nhập App +
đăng kyacute tagravei khoản
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của đối taacutec ĐỐI TAacuteC
(UserName Mật khẩu)
Khaacutech hagraveng lựa chọn tiacutenh năng đăng kyacute TK khaacutech hagraveng
tại MB
Bước 2 Nhập thocircng tin
giấy tờ tugravey thacircn
Khaacutech hagraveng
ĐỐI TAacuteC
Khaacutech hagraveng nhập thocircng tin giấy tờ tugravey thacircn
CMNDCCCD
- CMND Bao gồm CMND thường (9 vagrave 12 số) vagrave
CMND Sỹ quan
- CCCD Coacute độ dagravei lagrave 12 số
Bước 3 Kiểm tra khaacutech
hagraveng đatilde tồn tại
WALLET ID hay
chưa
ĐỐI TAacuteC ĐỐI TAacuteC kiểm tra thocircng tin khaacutech hagraveng đatilde tồn tại
wallet ID hay chưa
- Nếu đatilde coacute WALLET ID thigrave chuyển sang bước 31Gửi
thocircng tin WALLET ID Cho ĐỐI TAacuteC
- Nếu chưa coacute WALLET ID thigrave chuyển sang bước 32
Yecircu cầu eKYC
Bước 31 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 32 Yecircu cầu eKYC ĐỐI TAacuteC Đối taacutec ĐỐI TAacuteC gọi đến SDK do MB hoặc đối taacutec của
MB cung cấp thực hiện eKYC khaacutech hagraveng
Bước 4 Thực hiện eKYC Khaacutech hagraveng Khaacutech hagraveng thực hiện eKYC bao gồm
- Chụp CMND Mặt trước vagrave mặt sau
- Chụp chacircn dung Becircn traacutei becircn phải vagrave chiacutenh giữa
- Nhấn nuacutet tiếp tục
Bước 5 Kiểm tra thocircng tin
eKYC
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC thực hiện Config caacutec tham số vagrave
kiểm tra tiacutenh hợp lệ
- Khuocircn mặt khaacutech hagraveng coacute giống với khuocircn mặt chụp
trong giấy tờ tugravey thacircn khocircng
- Thocircng tin giấy tờ tugravey thacircn coacute đuacuteng với thocircng tin giấy tờ
Tugravey thacircn của KH trecircn hệ thống ĐỐI TAacuteC hay khocircng
- Caacutec thocircng tin khaacutec của khaacutech hagraveng như Ngagravey cấp
ngagravey sinh coacute hợp lệ hay khocircng ảnh chụp coacute bị loacutea hay
khocircng Giấy tờ tugravey thacircn bị cắt goacutec
=gt Nếu thocircng tin hợp lệ Chuyển sang bước 51 để gửi
thocircng tin cho MB
=gt Nếu thocircng tin khocircng hợp lệ chuyển sang bước 52
Trả về thocircng baacuteo lỗi tương ứng cho khaacutech hagraveng
Bước 51 Gửi thocircng tin cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- CMND
- SDT
Sang hệ thống MB
Bước 6 Kiếm tra KH coacute
walletID hay chưa
MB MB kiểm tra thocircng tin CMND coacute gắn với WALLET ID
khaacutech hagraveng hay khocircng
- Nếu coacute chuyển sang bước 61 Gửi thocircng tin
WALLET ID
- Nếu khocircng chuyển sang bước 7 Gửi thocircng tin
khaacutech hagraveng chưa coacute WALLET ID
Bước 61 Gửi thocircng tin
WALLET ID
MB MB gửi thocircng tin
- CMND
- WALLET ID tương ứng
Bước 62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho
khaacutech hagraveng
ĐỐI TAacuteC ĐỐI TAacuteC nhận thocircng tin WALLET ID từ MB vagrave lưu lại
thocircng tin trecircn hệ thống
- CMND
- WALLET ID
Sau đoacute gửi thocircng baacuteo cho khaacutech hagraveng
ldquoQuyacute khaacutech đatilde coacute tagravei khoản viacute ĐỐI TAacuteC vui lograveng tiếp
tục sủ dụng dịch vụrdquo
Bước 63 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 7 Gửi thocircng tin KH
chưa coacute WALLET
ID
GATEWAY MB MB gửi thocircng tin KH chưa coacute WALLET ID tại MB cho
ĐỐI TAacuteC
Bước 8 Tạo WALLET ID ĐỐI TAacuteC ĐỐI TAacuteC tạo WALLET ID
- Duy nhất trecircn hệ thống
- Gắn với CMND của KH
Bước 81 Gửi thocircng tin
WALLET ID cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- WALLET ID
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
MỤC LỤC
1 ĐĂNG KYacute MỞ TAgraveI KHOẢN ĐIỆN TỬ 3
a Mocirc tả chung 3
b Luồng quy trigravenh nghiệp vụ 3
c Luồng quy trigravenh tiacutech hợp 10
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ 16
a Mocirc tả chung 16
b Luồng quy trigravenh nghiệp vụ 16
c Luồng quy trigravenh tiacutech hợp 19
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT 23
a Mocirc tả chung 23
b Luồng quy trigravenh nghiệp vụ 23
c Luồng quy trigravenh tiacutech hợp 27
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT 30
a Mocirc tả chung 30
b Luồng quy trigravenh nghiệp vụ 30
c Luồng quy trigravenh tiacutech hợp 34
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB 37
a Mocirc tả chung 37
b Luồng quy trigravenh nghiệp vụ 38
c Luồng quy trigravenh tiacutech hợp 39
6 THANH TOAacuteN DỊCH VỤ 41
a Mocirc tả chung 41
b Luồng quy trigravenh nghiệp vụ 42
c Luồng quy trigravenh tiacutech hợp 43
1 ĐĂNG KYacute MỞ TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Đối với khaacutech hagraveng mới Cho pheacutep mở một tagravei khoản viacute điện tện tử của khaacutech hagraveng vagrave gắn
với kecircnh thực hiện từ đối taacutec
- Đối với khaacutech hagraveng đatilde tồn tại trecircn hệ thống MB Cho pheacutep gắn tagravei khoản thanh toaacuten đatilde tồn
tại trecircn hệ thống MB với thocircng tin điện tử của khaacutech hagraveng
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ quy trigravenh nghiệp vụ
LUỒNG QUY TRIgraveNH TẠO TAgraveI KHOẢN THANH TOAacuteN MBBANK
KHAacuteCH HAgraveNG ĐỐI TAacuteC GATEWAY MB T24
Ph
ase
Đăng nhập
1 Lựa chọn tiacutenh
năng Đăng kyacute tagravei
khoản
2 Nhập thocircng tin
giấy tờ tugravey thacircn
32Yecircu cầu eKYC4 Thực hiện eKYC
5 Thocircng tin
eKYC coacute hợp lệ
khocircng
82 Kiểm tra KH
đatilde coacute CODE tại
MB chưa
10 Kiếm tra KH
đatilde coacute tk MB
chưa
12 Gửi OTP cho
KH13 Nhập OTP
OTP coacute hợp lệ14 Tạo Code vagrave TK
mới cho KH
NO
11 Gửi yecircu cầu tạo
tk vagrave code mới cho
KH
17 Phản hồi kết quả
15 Lưu WALET ID
gắn với tagravei khoản
của KH 16 Lưu lại thocircng tin
token ID gắn với
user
18 Thocircng baacuteo kết
quả cho khaacutech hagravengEND NO
6 Kiểm tra xem
khaacutech hagraveng đatilde coacute
wallet ID hay
chưa
61 Gửi thocircng tin
WALLET ID
62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho KH
63 Nhận thocircng tin
tagravei khoản viacute vagrave kết
thuacutec
7 Gửi thocircng tin
khaacutech hagraveng chưa coacute
wallet ID
YES
9 Kiếm tra số
điện thoại KH
đăng kyacute coacute khớp
với SDT DNP
gửi hay khocircng
NO52Trả thocircng baacuteo lỗi
cho khaacutech hagraveng
YES
NO
3Kiểm tra
khaacutech hagraveng đatilde
coacute WALLET ID
hay chưa
YES
31 Hiển thị thocircng
tin khaacutech hagraveng đatilde
tồn tại WALLET ID
NO
51 Gửi thocircng tin
CMND vagrave SDT cho
MB
NO
YES
NO
8 Mở WALLETID
81 Gửi lại WALLET
ID số CMND vagrave
SDT
YES
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN Diễn giải
Bước 1 Đăng nhập App +
đăng kyacute tagravei khoản
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của đối taacutec ĐỐI TAacuteC
(UserName Mật khẩu)
Khaacutech hagraveng lựa chọn tiacutenh năng đăng kyacute TK khaacutech hagraveng
tại MB
Bước 2 Nhập thocircng tin
giấy tờ tugravey thacircn
Khaacutech hagraveng
ĐỐI TAacuteC
Khaacutech hagraveng nhập thocircng tin giấy tờ tugravey thacircn
CMNDCCCD
- CMND Bao gồm CMND thường (9 vagrave 12 số) vagrave
CMND Sỹ quan
- CCCD Coacute độ dagravei lagrave 12 số
Bước 3 Kiểm tra khaacutech
hagraveng đatilde tồn tại
WALLET ID hay
chưa
ĐỐI TAacuteC ĐỐI TAacuteC kiểm tra thocircng tin khaacutech hagraveng đatilde tồn tại
wallet ID hay chưa
- Nếu đatilde coacute WALLET ID thigrave chuyển sang bước 31Gửi
thocircng tin WALLET ID Cho ĐỐI TAacuteC
- Nếu chưa coacute WALLET ID thigrave chuyển sang bước 32
Yecircu cầu eKYC
Bước 31 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 32 Yecircu cầu eKYC ĐỐI TAacuteC Đối taacutec ĐỐI TAacuteC gọi đến SDK do MB hoặc đối taacutec của
MB cung cấp thực hiện eKYC khaacutech hagraveng
Bước 4 Thực hiện eKYC Khaacutech hagraveng Khaacutech hagraveng thực hiện eKYC bao gồm
- Chụp CMND Mặt trước vagrave mặt sau
- Chụp chacircn dung Becircn traacutei becircn phải vagrave chiacutenh giữa
- Nhấn nuacutet tiếp tục
Bước 5 Kiểm tra thocircng tin
eKYC
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC thực hiện Config caacutec tham số vagrave
kiểm tra tiacutenh hợp lệ
- Khuocircn mặt khaacutech hagraveng coacute giống với khuocircn mặt chụp
trong giấy tờ tugravey thacircn khocircng
- Thocircng tin giấy tờ tugravey thacircn coacute đuacuteng với thocircng tin giấy tờ
Tugravey thacircn của KH trecircn hệ thống ĐỐI TAacuteC hay khocircng
- Caacutec thocircng tin khaacutec của khaacutech hagraveng như Ngagravey cấp
ngagravey sinh coacute hợp lệ hay khocircng ảnh chụp coacute bị loacutea hay
khocircng Giấy tờ tugravey thacircn bị cắt goacutec
=gt Nếu thocircng tin hợp lệ Chuyển sang bước 51 để gửi
thocircng tin cho MB
=gt Nếu thocircng tin khocircng hợp lệ chuyển sang bước 52
Trả về thocircng baacuteo lỗi tương ứng cho khaacutech hagraveng
Bước 51 Gửi thocircng tin cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- CMND
- SDT
Sang hệ thống MB
Bước 6 Kiếm tra KH coacute
walletID hay chưa
MB MB kiểm tra thocircng tin CMND coacute gắn với WALLET ID
khaacutech hagraveng hay khocircng
- Nếu coacute chuyển sang bước 61 Gửi thocircng tin
WALLET ID
- Nếu khocircng chuyển sang bước 7 Gửi thocircng tin
khaacutech hagraveng chưa coacute WALLET ID
Bước 61 Gửi thocircng tin
WALLET ID
MB MB gửi thocircng tin
- CMND
- WALLET ID tương ứng
Bước 62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho
khaacutech hagraveng
ĐỐI TAacuteC ĐỐI TAacuteC nhận thocircng tin WALLET ID từ MB vagrave lưu lại
thocircng tin trecircn hệ thống
- CMND
- WALLET ID
Sau đoacute gửi thocircng baacuteo cho khaacutech hagraveng
ldquoQuyacute khaacutech đatilde coacute tagravei khoản viacute ĐỐI TAacuteC vui lograveng tiếp
tục sủ dụng dịch vụrdquo
Bước 63 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 7 Gửi thocircng tin KH
chưa coacute WALLET
ID
GATEWAY MB MB gửi thocircng tin KH chưa coacute WALLET ID tại MB cho
ĐỐI TAacuteC
Bước 8 Tạo WALLET ID ĐỐI TAacuteC ĐỐI TAacuteC tạo WALLET ID
- Duy nhất trecircn hệ thống
- Gắn với CMND của KH
Bước 81 Gửi thocircng tin
WALLET ID cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- WALLET ID
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
1 ĐĂNG KYacute MỞ TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Đối với khaacutech hagraveng mới Cho pheacutep mở một tagravei khoản viacute điện tện tử của khaacutech hagraveng vagrave gắn
với kecircnh thực hiện từ đối taacutec
- Đối với khaacutech hagraveng đatilde tồn tại trecircn hệ thống MB Cho pheacutep gắn tagravei khoản thanh toaacuten đatilde tồn
tại trecircn hệ thống MB với thocircng tin điện tử của khaacutech hagraveng
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ quy trigravenh nghiệp vụ
LUỒNG QUY TRIgraveNH TẠO TAgraveI KHOẢN THANH TOAacuteN MBBANK
KHAacuteCH HAgraveNG ĐỐI TAacuteC GATEWAY MB T24
Ph
ase
Đăng nhập
1 Lựa chọn tiacutenh
năng Đăng kyacute tagravei
khoản
2 Nhập thocircng tin
giấy tờ tugravey thacircn
32Yecircu cầu eKYC4 Thực hiện eKYC
5 Thocircng tin
eKYC coacute hợp lệ
khocircng
82 Kiểm tra KH
đatilde coacute CODE tại
MB chưa
10 Kiếm tra KH
đatilde coacute tk MB
chưa
12 Gửi OTP cho
KH13 Nhập OTP
OTP coacute hợp lệ14 Tạo Code vagrave TK
mới cho KH
NO
11 Gửi yecircu cầu tạo
tk vagrave code mới cho
KH
17 Phản hồi kết quả
15 Lưu WALET ID
gắn với tagravei khoản
của KH 16 Lưu lại thocircng tin
token ID gắn với
user
18 Thocircng baacuteo kết
quả cho khaacutech hagravengEND NO
6 Kiểm tra xem
khaacutech hagraveng đatilde coacute
wallet ID hay
chưa
61 Gửi thocircng tin
WALLET ID
62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho KH
63 Nhận thocircng tin
tagravei khoản viacute vagrave kết
thuacutec
7 Gửi thocircng tin
khaacutech hagraveng chưa coacute
wallet ID
YES
9 Kiếm tra số
điện thoại KH
đăng kyacute coacute khớp
với SDT DNP
gửi hay khocircng
NO52Trả thocircng baacuteo lỗi
cho khaacutech hagraveng
YES
NO
3Kiểm tra
khaacutech hagraveng đatilde
coacute WALLET ID
hay chưa
YES
31 Hiển thị thocircng
tin khaacutech hagraveng đatilde
tồn tại WALLET ID
NO
51 Gửi thocircng tin
CMND vagrave SDT cho
MB
NO
YES
NO
8 Mở WALLETID
81 Gửi lại WALLET
ID số CMND vagrave
SDT
YES
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN Diễn giải
Bước 1 Đăng nhập App +
đăng kyacute tagravei khoản
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của đối taacutec ĐỐI TAacuteC
(UserName Mật khẩu)
Khaacutech hagraveng lựa chọn tiacutenh năng đăng kyacute TK khaacutech hagraveng
tại MB
Bước 2 Nhập thocircng tin
giấy tờ tugravey thacircn
Khaacutech hagraveng
ĐỐI TAacuteC
Khaacutech hagraveng nhập thocircng tin giấy tờ tugravey thacircn
CMNDCCCD
- CMND Bao gồm CMND thường (9 vagrave 12 số) vagrave
CMND Sỹ quan
- CCCD Coacute độ dagravei lagrave 12 số
Bước 3 Kiểm tra khaacutech
hagraveng đatilde tồn tại
WALLET ID hay
chưa
ĐỐI TAacuteC ĐỐI TAacuteC kiểm tra thocircng tin khaacutech hagraveng đatilde tồn tại
wallet ID hay chưa
- Nếu đatilde coacute WALLET ID thigrave chuyển sang bước 31Gửi
thocircng tin WALLET ID Cho ĐỐI TAacuteC
- Nếu chưa coacute WALLET ID thigrave chuyển sang bước 32
Yecircu cầu eKYC
Bước 31 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 32 Yecircu cầu eKYC ĐỐI TAacuteC Đối taacutec ĐỐI TAacuteC gọi đến SDK do MB hoặc đối taacutec của
MB cung cấp thực hiện eKYC khaacutech hagraveng
Bước 4 Thực hiện eKYC Khaacutech hagraveng Khaacutech hagraveng thực hiện eKYC bao gồm
- Chụp CMND Mặt trước vagrave mặt sau
- Chụp chacircn dung Becircn traacutei becircn phải vagrave chiacutenh giữa
- Nhấn nuacutet tiếp tục
Bước 5 Kiểm tra thocircng tin
eKYC
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC thực hiện Config caacutec tham số vagrave
kiểm tra tiacutenh hợp lệ
- Khuocircn mặt khaacutech hagraveng coacute giống với khuocircn mặt chụp
trong giấy tờ tugravey thacircn khocircng
- Thocircng tin giấy tờ tugravey thacircn coacute đuacuteng với thocircng tin giấy tờ
Tugravey thacircn của KH trecircn hệ thống ĐỐI TAacuteC hay khocircng
- Caacutec thocircng tin khaacutec của khaacutech hagraveng như Ngagravey cấp
ngagravey sinh coacute hợp lệ hay khocircng ảnh chụp coacute bị loacutea hay
khocircng Giấy tờ tugravey thacircn bị cắt goacutec
=gt Nếu thocircng tin hợp lệ Chuyển sang bước 51 để gửi
thocircng tin cho MB
=gt Nếu thocircng tin khocircng hợp lệ chuyển sang bước 52
Trả về thocircng baacuteo lỗi tương ứng cho khaacutech hagraveng
Bước 51 Gửi thocircng tin cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- CMND
- SDT
Sang hệ thống MB
Bước 6 Kiếm tra KH coacute
walletID hay chưa
MB MB kiểm tra thocircng tin CMND coacute gắn với WALLET ID
khaacutech hagraveng hay khocircng
- Nếu coacute chuyển sang bước 61 Gửi thocircng tin
WALLET ID
- Nếu khocircng chuyển sang bước 7 Gửi thocircng tin
khaacutech hagraveng chưa coacute WALLET ID
Bước 61 Gửi thocircng tin
WALLET ID
MB MB gửi thocircng tin
- CMND
- WALLET ID tương ứng
Bước 62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho
khaacutech hagraveng
ĐỐI TAacuteC ĐỐI TAacuteC nhận thocircng tin WALLET ID từ MB vagrave lưu lại
thocircng tin trecircn hệ thống
- CMND
- WALLET ID
Sau đoacute gửi thocircng baacuteo cho khaacutech hagraveng
ldquoQuyacute khaacutech đatilde coacute tagravei khoản viacute ĐỐI TAacuteC vui lograveng tiếp
tục sủ dụng dịch vụrdquo
Bước 63 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 7 Gửi thocircng tin KH
chưa coacute WALLET
ID
GATEWAY MB MB gửi thocircng tin KH chưa coacute WALLET ID tại MB cho
ĐỐI TAacuteC
Bước 8 Tạo WALLET ID ĐỐI TAacuteC ĐỐI TAacuteC tạo WALLET ID
- Duy nhất trecircn hệ thống
- Gắn với CMND của KH
Bước 81 Gửi thocircng tin
WALLET ID cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- WALLET ID
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
LUỒNG QUY TRIgraveNH TẠO TAgraveI KHOẢN THANH TOAacuteN MBBANK
KHAacuteCH HAgraveNG ĐỐI TAacuteC GATEWAY MB T24
Ph
ase
Đăng nhập
1 Lựa chọn tiacutenh
năng Đăng kyacute tagravei
khoản
2 Nhập thocircng tin
giấy tờ tugravey thacircn
32Yecircu cầu eKYC4 Thực hiện eKYC
5 Thocircng tin
eKYC coacute hợp lệ
khocircng
82 Kiểm tra KH
đatilde coacute CODE tại
MB chưa
10 Kiếm tra KH
đatilde coacute tk MB
chưa
12 Gửi OTP cho
KH13 Nhập OTP
OTP coacute hợp lệ14 Tạo Code vagrave TK
mới cho KH
NO
11 Gửi yecircu cầu tạo
tk vagrave code mới cho
KH
17 Phản hồi kết quả
15 Lưu WALET ID
gắn với tagravei khoản
của KH 16 Lưu lại thocircng tin
token ID gắn với
user
18 Thocircng baacuteo kết
quả cho khaacutech hagravengEND NO
6 Kiểm tra xem
khaacutech hagraveng đatilde coacute
wallet ID hay
chưa
61 Gửi thocircng tin
WALLET ID
62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho KH
63 Nhận thocircng tin
tagravei khoản viacute vagrave kết
thuacutec
7 Gửi thocircng tin
khaacutech hagraveng chưa coacute
wallet ID
YES
9 Kiếm tra số
điện thoại KH
đăng kyacute coacute khớp
với SDT DNP
gửi hay khocircng
NO52Trả thocircng baacuteo lỗi
cho khaacutech hagraveng
YES
NO
3Kiểm tra
khaacutech hagraveng đatilde
coacute WALLET ID
hay chưa
YES
31 Hiển thị thocircng
tin khaacutech hagraveng đatilde
tồn tại WALLET ID
NO
51 Gửi thocircng tin
CMND vagrave SDT cho
MB
NO
YES
NO
8 Mở WALLETID
81 Gửi lại WALLET
ID số CMND vagrave
SDT
YES
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN Diễn giải
Bước 1 Đăng nhập App +
đăng kyacute tagravei khoản
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của đối taacutec ĐỐI TAacuteC
(UserName Mật khẩu)
Khaacutech hagraveng lựa chọn tiacutenh năng đăng kyacute TK khaacutech hagraveng
tại MB
Bước 2 Nhập thocircng tin
giấy tờ tugravey thacircn
Khaacutech hagraveng
ĐỐI TAacuteC
Khaacutech hagraveng nhập thocircng tin giấy tờ tugravey thacircn
CMNDCCCD
- CMND Bao gồm CMND thường (9 vagrave 12 số) vagrave
CMND Sỹ quan
- CCCD Coacute độ dagravei lagrave 12 số
Bước 3 Kiểm tra khaacutech
hagraveng đatilde tồn tại
WALLET ID hay
chưa
ĐỐI TAacuteC ĐỐI TAacuteC kiểm tra thocircng tin khaacutech hagraveng đatilde tồn tại
wallet ID hay chưa
- Nếu đatilde coacute WALLET ID thigrave chuyển sang bước 31Gửi
thocircng tin WALLET ID Cho ĐỐI TAacuteC
- Nếu chưa coacute WALLET ID thigrave chuyển sang bước 32
Yecircu cầu eKYC
Bước 31 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 32 Yecircu cầu eKYC ĐỐI TAacuteC Đối taacutec ĐỐI TAacuteC gọi đến SDK do MB hoặc đối taacutec của
MB cung cấp thực hiện eKYC khaacutech hagraveng
Bước 4 Thực hiện eKYC Khaacutech hagraveng Khaacutech hagraveng thực hiện eKYC bao gồm
- Chụp CMND Mặt trước vagrave mặt sau
- Chụp chacircn dung Becircn traacutei becircn phải vagrave chiacutenh giữa
- Nhấn nuacutet tiếp tục
Bước 5 Kiểm tra thocircng tin
eKYC
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC thực hiện Config caacutec tham số vagrave
kiểm tra tiacutenh hợp lệ
- Khuocircn mặt khaacutech hagraveng coacute giống với khuocircn mặt chụp
trong giấy tờ tugravey thacircn khocircng
- Thocircng tin giấy tờ tugravey thacircn coacute đuacuteng với thocircng tin giấy tờ
Tugravey thacircn của KH trecircn hệ thống ĐỐI TAacuteC hay khocircng
- Caacutec thocircng tin khaacutec của khaacutech hagraveng như Ngagravey cấp
ngagravey sinh coacute hợp lệ hay khocircng ảnh chụp coacute bị loacutea hay
khocircng Giấy tờ tugravey thacircn bị cắt goacutec
=gt Nếu thocircng tin hợp lệ Chuyển sang bước 51 để gửi
thocircng tin cho MB
=gt Nếu thocircng tin khocircng hợp lệ chuyển sang bước 52
Trả về thocircng baacuteo lỗi tương ứng cho khaacutech hagraveng
Bước 51 Gửi thocircng tin cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- CMND
- SDT
Sang hệ thống MB
Bước 6 Kiếm tra KH coacute
walletID hay chưa
MB MB kiểm tra thocircng tin CMND coacute gắn với WALLET ID
khaacutech hagraveng hay khocircng
- Nếu coacute chuyển sang bước 61 Gửi thocircng tin
WALLET ID
- Nếu khocircng chuyển sang bước 7 Gửi thocircng tin
khaacutech hagraveng chưa coacute WALLET ID
Bước 61 Gửi thocircng tin
WALLET ID
MB MB gửi thocircng tin
- CMND
- WALLET ID tương ứng
Bước 62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho
khaacutech hagraveng
ĐỐI TAacuteC ĐỐI TAacuteC nhận thocircng tin WALLET ID từ MB vagrave lưu lại
thocircng tin trecircn hệ thống
- CMND
- WALLET ID
Sau đoacute gửi thocircng baacuteo cho khaacutech hagraveng
ldquoQuyacute khaacutech đatilde coacute tagravei khoản viacute ĐỐI TAacuteC vui lograveng tiếp
tục sủ dụng dịch vụrdquo
Bước 63 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 7 Gửi thocircng tin KH
chưa coacute WALLET
ID
GATEWAY MB MB gửi thocircng tin KH chưa coacute WALLET ID tại MB cho
ĐỐI TAacuteC
Bước 8 Tạo WALLET ID ĐỐI TAacuteC ĐỐI TAacuteC tạo WALLET ID
- Duy nhất trecircn hệ thống
- Gắn với CMND của KH
Bước 81 Gửi thocircng tin
WALLET ID cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- WALLET ID
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
STT NỘI DUNG NGƯỜI THỰC HIỆN Diễn giải
Bước 1 Đăng nhập App +
đăng kyacute tagravei khoản
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của đối taacutec ĐỐI TAacuteC
(UserName Mật khẩu)
Khaacutech hagraveng lựa chọn tiacutenh năng đăng kyacute TK khaacutech hagraveng
tại MB
Bước 2 Nhập thocircng tin
giấy tờ tugravey thacircn
Khaacutech hagraveng
ĐỐI TAacuteC
Khaacutech hagraveng nhập thocircng tin giấy tờ tugravey thacircn
CMNDCCCD
- CMND Bao gồm CMND thường (9 vagrave 12 số) vagrave
CMND Sỹ quan
- CCCD Coacute độ dagravei lagrave 12 số
Bước 3 Kiểm tra khaacutech
hagraveng đatilde tồn tại
WALLET ID hay
chưa
ĐỐI TAacuteC ĐỐI TAacuteC kiểm tra thocircng tin khaacutech hagraveng đatilde tồn tại
wallet ID hay chưa
- Nếu đatilde coacute WALLET ID thigrave chuyển sang bước 31Gửi
thocircng tin WALLET ID Cho ĐỐI TAacuteC
- Nếu chưa coacute WALLET ID thigrave chuyển sang bước 32
Yecircu cầu eKYC
Bước 31 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 32 Yecircu cầu eKYC ĐỐI TAacuteC Đối taacutec ĐỐI TAacuteC gọi đến SDK do MB hoặc đối taacutec của
MB cung cấp thực hiện eKYC khaacutech hagraveng
Bước 4 Thực hiện eKYC Khaacutech hagraveng Khaacutech hagraveng thực hiện eKYC bao gồm
- Chụp CMND Mặt trước vagrave mặt sau
- Chụp chacircn dung Becircn traacutei becircn phải vagrave chiacutenh giữa
- Nhấn nuacutet tiếp tục
Bước 5 Kiểm tra thocircng tin
eKYC
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC thực hiện Config caacutec tham số vagrave
kiểm tra tiacutenh hợp lệ
- Khuocircn mặt khaacutech hagraveng coacute giống với khuocircn mặt chụp
trong giấy tờ tugravey thacircn khocircng
- Thocircng tin giấy tờ tugravey thacircn coacute đuacuteng với thocircng tin giấy tờ
Tugravey thacircn của KH trecircn hệ thống ĐỐI TAacuteC hay khocircng
- Caacutec thocircng tin khaacutec của khaacutech hagraveng như Ngagravey cấp
ngagravey sinh coacute hợp lệ hay khocircng ảnh chụp coacute bị loacutea hay
khocircng Giấy tờ tugravey thacircn bị cắt goacutec
=gt Nếu thocircng tin hợp lệ Chuyển sang bước 51 để gửi
thocircng tin cho MB
=gt Nếu thocircng tin khocircng hợp lệ chuyển sang bước 52
Trả về thocircng baacuteo lỗi tương ứng cho khaacutech hagraveng
Bước 51 Gửi thocircng tin cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- CMND
- SDT
Sang hệ thống MB
Bước 6 Kiếm tra KH coacute
walletID hay chưa
MB MB kiểm tra thocircng tin CMND coacute gắn với WALLET ID
khaacutech hagraveng hay khocircng
- Nếu coacute chuyển sang bước 61 Gửi thocircng tin
WALLET ID
- Nếu khocircng chuyển sang bước 7 Gửi thocircng tin
khaacutech hagraveng chưa coacute WALLET ID
Bước 61 Gửi thocircng tin
WALLET ID
MB MB gửi thocircng tin
- CMND
- WALLET ID tương ứng
Bước 62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho
khaacutech hagraveng
ĐỐI TAacuteC ĐỐI TAacuteC nhận thocircng tin WALLET ID từ MB vagrave lưu lại
thocircng tin trecircn hệ thống
- CMND
- WALLET ID
Sau đoacute gửi thocircng baacuteo cho khaacutech hagraveng
ldquoQuyacute khaacutech đatilde coacute tagravei khoản viacute ĐỐI TAacuteC vui lograveng tiếp
tục sủ dụng dịch vụrdquo
Bước 63 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 7 Gửi thocircng tin KH
chưa coacute WALLET
ID
GATEWAY MB MB gửi thocircng tin KH chưa coacute WALLET ID tại MB cho
ĐỐI TAacuteC
Bước 8 Tạo WALLET ID ĐỐI TAacuteC ĐỐI TAacuteC tạo WALLET ID
- Duy nhất trecircn hệ thống
- Gắn với CMND của KH
Bước 81 Gửi thocircng tin
WALLET ID cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- WALLET ID
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
thocircng tin cho MB
=gt Nếu thocircng tin khocircng hợp lệ chuyển sang bước 52
Trả về thocircng baacuteo lỗi tương ứng cho khaacutech hagraveng
Bước 51 Gửi thocircng tin cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- CMND
- SDT
Sang hệ thống MB
Bước 6 Kiếm tra KH coacute
walletID hay chưa
MB MB kiểm tra thocircng tin CMND coacute gắn với WALLET ID
khaacutech hagraveng hay khocircng
- Nếu coacute chuyển sang bước 61 Gửi thocircng tin
WALLET ID
- Nếu khocircng chuyển sang bước 7 Gửi thocircng tin
khaacutech hagraveng chưa coacute WALLET ID
Bước 61 Gửi thocircng tin
WALLET ID
MB MB gửi thocircng tin
- CMND
- WALLET ID tương ứng
Bước 62 Lưu lại thocircng tin
WALLET ID vagrave
thocircng baacuteo cho
khaacutech hagraveng
ĐỐI TAacuteC ĐỐI TAacuteC nhận thocircng tin WALLET ID từ MB vagrave lưu lại
thocircng tin trecircn hệ thống
- CMND
- WALLET ID
Sau đoacute gửi thocircng baacuteo cho khaacutech hagraveng
ldquoQuyacute khaacutech đatilde coacute tagravei khoản viacute ĐỐI TAacuteC vui lograveng tiếp
tục sủ dụng dịch vụrdquo
Bước 63 Nhận thocircng tin tagravei
khoản viacute vagrave kết
thuacutec
Khaacutech hagraveng Khaacutech hagraveng nhận thocircng tin tagravei khoản viacute của KH vagrave kết
thuacutec
Bước 7 Gửi thocircng tin KH
chưa coacute WALLET
ID
GATEWAY MB MB gửi thocircng tin KH chưa coacute WALLET ID tại MB cho
ĐỐI TAacuteC
Bước 8 Tạo WALLET ID ĐỐI TAacuteC ĐỐI TAacuteC tạo WALLET ID
- Duy nhất trecircn hệ thống
- Gắn với CMND của KH
Bước 81 Gửi thocircng tin
WALLET ID cho
MB
ĐỐI TAacuteC ĐỐI TAacuteC gửi thocircng tin
- WALLET ID
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- Số CMND
- Số điện thoại
Bước 82 Kiểm tra KH coacute
Code tại MB
GateWay MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute Code KH
tại MB hay chưa
Dựa vagraveo thocircng tin CMND đối taacutec gửi sang
- Nếu KH đatilde coacute Code tại MB Chuyển sang bước 9
Kiểm tra xem số điện thoại của KH coacute khớp với SDT
ĐỐI TAacuteC gửi hay khocircng
- Nếu KH chưa coacute Code tại MB Chuyển sang bước 11
để yecircu cầu tạo code vagrave tagravei khoản cho khaacutech hagraveng
Bước 9 Kiểm tra số điện
thoại của KH của
khaacutech hagraveng coacute
trugraveng với SDT lưu
trecircn hệ thống MB
khocircng
GATEWAY MB Hệ thống MB kiểm tra thocircng tin ĐỐI TAacuteC gửi coacute trung
khớp với thocircng tin KH lưu tại MB hay khocircng
- Nếu SDT của KH trugraveng với SDT lưu tại hệ thống core
MB =gt chuyển sang bước 10 Kiểm tra KH đatilde coacute tagravei
khoản tại MB hay chưa
- Nếu SDT của KH khocircng trugraveng với SDT lưu tại hệ
thống core MB =gt Gửi baacuteo lỗi cho ĐỐI TAacuteC ldquoSố điện
thoại đăng kyacute khocircng trugraveng với SDT lưu tại MBrdquo vagrave kết
thuacutec
Bước 10 Kiểm tra KH coacute
TK tại MB
T24 MB Hệ thống MB kiểm tra khaacutech hagraveng xem đatilde coacute TK KH tại
MB hay chưa
Lựa chọn tagravei khoản theo quy tắc sau
- Nếu KH coacute 1 tagravei khoản =gt chọn tagravei khoản đoacute lagrave tagravei
khoản liecircn kết
- Nếu KH đatilde coacute Tagravei khoản vocirc danh tại MB
Sector 1911
Category 4202
Sub 713
Chuyển tk sang
Sector 1917
Category 1001
Sub 713
- Nếu KH coacute tagravei 1 khoản định danh tại MB chọn
luocircn tagravei khoản nagravey lagrave tagravei khoản liecircn kết
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- Nếu KH coacute nhiều hơn 1 tagravei khoản
+ Chọn tagravei khoản coacute số dư lớn nhất để liecircn kết
+ Nếu tagravei khoản số dư cao hơn lagrave tk vocirc danh thigrave chọn
tagravei khoản định danh coacute số dư lớn nhất
+Nếu số dư caacutec tagravei khoản bằng nhau =gt chọn tagravei khoản
ngẫu nhiecircn
Chuyển sang bước 12 Gưi yecircu cầu tạo WALLET ID
- Nếu KH chưa coacute Tagravei khoản MB Chuyển sang bước 14
để yecircu cầu tạo tagravei khoản cho khaacutech hagraveng
Bước 11 Gửi yecircu cầu tạo TK GATEWAY MB Gateway MB gửi yecircu cầu tạo code mới vagrave tk mới
cho KH
Bước 12 Gửi matilde OTP cho
khaacutech hagraveng
GateWay MB Hệ thống GateWay MB tạo OTP đến số điện thoại cho
khaacutech hagraveng
- Nếu tạo Code khaacutech hagraveng mới Gửi OTP đến số điện
thoại khaacutech hagraveng đăng kyacute trecircn App của ĐỐI TAacuteC
- Nếu tạo TK Gửi OTP đến số điện thoại khaacutech hagraveng
đăng kyacute tại MB trước đoacute
+ Nếu thocircng tin Số điện thoại khaacutech hagraveng gửi sang magrave
khaacutech hagraveng đatilde coacute tại MB nhưng khaacutec số điện thoại
khaacutech hagraveng đăng kyacute tại MB (Trecircn hệ thống T24) MB trả
thocircng baacuteo lỗi cho khaacutech hagraveng ldquoSố điện thoại đăng kyacute
khocircng đuacuteng với số điện thoại đăng kyacute tại ngacircn hagraveng vui
lograveng kiểm tra lạirdquo
+ Nếu thocircng tin số điện thoại khaacutech hagraveng guiwe sang magrave
trugraveng thocircng tin số điện thoại đăng kyacute tại MB MB gửi
OTP cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Bước 13 KH nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde OTP vagrave đối taacutec gửi matilde OTP sang
MB để kiểm tra
Kiểm tra matilde OTP Hệ thống MB Hệ thống MB kiểm tra thocircng tin matilde OTP
- Nếu thocircng tin matilde OTP khocircng hợp lệ hiển thị thocircng
baacuteo lỗi ldquoMatilde xaacutec thực khocircng hợp lệrdquo
- Nếu thocircng tin matilde OTP nhập sai quaacute 3 lần hiển thị
thocircng baacuteo lỗi ldquoBạn nhập sai quaacute 3 lần vui lograveng thực
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
hiện lại giao dịch saurdquo
- Nếu thocircng tin hợp lệ Chuyển sang bước 11 tạo Code
vagrave TK cho khaacutech hagraveng
Bước 14 Tạo Code vagrave TK
cho KH
Hệ thống MB - Hệ thống ĐỐI TAacuteC gửi yecircu cầu đăng kyacute tagravei khoản
sang Ngacircn hagraveng bao gồm caacutec trường thocircng tin sau
+ Họ vagrave tecircn khaacutech hagraveng
+ Số CMND
+ Ngagravey thaacuteng năm sinh
+ Giới tiacutenh
+ Quecirc quản
+ Nơi thường truacute
+ Ngagravey cấp nơi cấp
+ Địa chỉ email
+ Số điện thoại
- Hệ thống MB thực hiện Tạo Code vagrave TK khaacutech hagraveng
theo nguyecircn tắc sau
KH đatilde coacute code tại MB =gtHệ thống MB gửi yecircu cầu tạo
tagravei khoản mới cho khaacutech hagraveng
o Mở TK của KH với Category lagrave
1001
o Channel [Đối taacutec tương ứng]
KH chua coacute code tại MB =gtHệ thống MB gửi yecircu cầu
tạo Code mới vagrave tk mới cho khaacutech hagraveng
- Thocircng tin Client Caacutec thocircng tin chiacutenh do đối
taacutec truyền sang vagrave lưu yacute
o Thocircng tin Sector sẽ lagrave 1917
o company book lagrave Hội sở
- Thocircng tin Tagravei khoản category 1001
company book lagrave Hội sở
Channel [Tương ứng với đối taacutec]
MB gửi thocircng baacuteo kết quả mở tagravei khoản mới thagravenh cocircng
qua email cho khaacutech hagraveng
Bước 15 Lưu lại wallet ID
gắn với tagravei khoản
của KH
Gateway MB MB lưu lại wallet ID gắn với tagravei khoản khaacutech hagraveng dugraveng
cho DV ĐỐI TAacuteC vagraveo hệ thống
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
Bước 16 Lưu lại thocircng tin
wallet ID gắn với
user
ĐỐI TAacuteC ĐỐI TAacuteC lưu lại wallet ID tương ứng với CMND user
trecircn hệ thống
Bước 17 Phản hồi kết quả Hệ thống MB Thocircng baacuteo kết quả cho khaacutech hagraveng
+ MB trả về kết quả thocircng baacuteo lỗi ĐỐI TAacuteC phản hồi
kết quả lỗi tương ứng
+ MB tạo kết quả thagravenh cocircng
bull MB tạo liecircn kết với ĐỐI TAacuteC bằng tagravei khoản liecircn
kết với dịch vụ eMB
MB vagrave ĐỐI TAacuteC thocircng baacuteo caacutec dịch vụ mở thagravenh cocircng
tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Create ewallet request
URL https[IPDOMAIN][PORT]msewalletv11registerrequest
Method POST
Description Gửi yecircu cầu đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
customerName Họ tecircn khaacutech hagraveng String M 35
nationalID Số GTTT String M 20
dateOfIssue Ngagravey cấp(yyyy-MM-ddTHHmmss) String M -
placeOfIssue Nơi cấp String O 35
phoneNumber Số điện thoại String M 20
emailAddress Địa chỉ email String M 35
dateOfBirth Ngagravey sinh (yyyy-MM-ddTHHmmss) String M -
gender Giới tiacutenh (MALEFEMAIL) String M -
residenceAddress
Địa chỉ thường truacute (gheacutep chuỗi từ
residenceWardCode
residencedistrictCode
residenceTownCode residenceStreet)
String
M 225
residenceWardCode Matilde TỉnhThagravenh phố thường truacute (lấy mặc
định 00178)
String O 5
residencedistrictCode Matilde QuậnHuyện thường truacute (lấy mặc
định 006)
String O 5
residenceTownCode
Matilde PhườngXatilde thường truacute
(lấy mặc định 01)
String
O 5
residenceStreet
Địa chỉ đường phố thường truacute (lấy
mặc định 21 Cat Linh)
String
O 35
currentAddress
Địa chỉ hiện tại
(gheacutepchuỗi từ currentWardCode
currentdistrictCode currentTownCode
currentStreet)
String O 225
currentWardCode Matilde TỉnhThagravenh phố hiện tại (lấy mặc
định 00178)
String O 5
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
currentdistrictCode
Matilde QuậnHuyện hiện tại
(lấy mặc định 006)
String
O 5
currentTownCode
Matilde PhườngXatilde hiện tại
(lấy mặc định 01)
String
O 5
currentStreet Địa chỉ đường phố hiện tại (lấy mặc
định 21 Cat Linh)
String
O 35
fileName Tecircn file chữ kyacute (jpg) String O -
fileContent Base64String String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtrequestId Matilde khaacutech hagraveng String M
gtmobile Số điện thoại khaacutech hagraveng String M
- Example
+ Input
currentAddress string
currentStreet 21 Cat Linh
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
currentTownCode 01
currentWardCode 00178
currentdistrictCode 006
customerName Nguyen Van A
dateOfBirth 1987-05-15T000000
dateOfIssue 1987-05-15T000000
emailAddress examplembbankcomvn
fileContent
TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb2
4sIGJ1dCBieSB0aGlznIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbml
tYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgndGhlIG1pbmQsIHRoYXQgYnkg
YSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGlundWV
kIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLC
BleGNlZWRzIHRonZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hb
CBwbGVhc3VyZS4=
fileName examplejpg
gender MALE
nationalID 13512654
phoneNumber 0986868686
placeOfIssue 21 Cat Linh Ha Noi
residenceAddress string
residenceStreet 21 Cat Linh
residenceTownCode 01
residenceWardCode 00178
residencedistrictCode 006
walletID V3GOSWKI
+ Output
clientMessageId string
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
data
mobile 0986868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
ii) Create ewallter confirm
URL https[IPDOMAIN][PORT]msewalletv11registerconfirm
Method POST
Description Xaacutec nhận đăng kiacute viacute điện tử
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
status http status String M
error http error String M
path path String M
soaErrorCode SOA error code (error code detail) String M
soaErrorDesc SOA error message String O
data Kết quả xử lyacute Object O
gtcustomerID Matilde khaacutech hagraveng String M
gtaccountNumber Số tagravei khoản khaacutech hagraveng String M
- Example
+ Input
otp 86868686
requestId b780f5e3-a661-4d6c-9e3f-942ecd1eeaa2
+ Output
clientMessageId string
data
accountNumber 0000100029651
customerID OK-V3GOSWKI
error string
path string
soaErrorCode string
soaErrorDesc string
status 200
iii) Matilde lỗi
- 204 National Identity is invalid
- 2040 National Identity already exists
- 206 File type is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 237 PIN or OTP is incorrect or expired
- 268 Invalid issue date
- 278 Wallet ID is invalid
- 2780 Wallet ID already exists
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- 279 Customer name is invalid
- 280 Email is invalid
- 281 Date of birth is invalid
- 4080 Service not declare in config
- 4630 Invalid request
- 500 Unknown error
- 282 Gender is invalid
- 502 Database error
- 290 Input place of issue invalid
- 2860 Current or residence address is invalid
- 288 Current or residence street is invalid
- 289 Current or residence town code is invalid
- 2940 Current or residence ward code is invalid
- 287 Current or residence district code is invalid
2 LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng thực hiện liecircn kết với thẻ ngoagravei MB với tagravei khoản điện tử qua tiacutenh năng
CashinEcom của Napas
- Khi liecircn kết sẽ thực hiện nạp tiền vagraveo tagravei khoản điện tử với số tiền giao dịch tối thiểu đa phần
Caacutec ngacircn hagraveng sẽ lagrave 3000 VNĐ Tuy nhiecircn coacute 1 số bank sẽ coacute số tiền tối thiểu lagrave 10000
VNĐ (Như VietcombankNHTMCP Bản Việt NHTMCP Đại chuacuteng Việt Nam)
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
LIEcircN KẾT THẺ NGOAgraveI MB VỚI TAgraveI KHOẢN ĐIỆN TỬ QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
LIEcirc
N K
ẾT
TH
Ẻ N
GO
AgraveI
MB
VỚ
I T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Liecircn kết TKĐT
2 KH Nhập thocircng tin
Liecircn kết TKĐT
3 Gửi yecircu cầu
Liecircn kết TKĐT
4 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
kegravem tạo Token
5 Gửi yecircu cầu nạp
tiền vagraveo TKĐT
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11 Khởi tạo
Token
12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng liecircn
kết TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng liecircn kết tagravei khoản điện
tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2 để
nhập thocircng tin liecircn kết
2 KH Nhập thocircng tin
liecircn kết TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập thocircng tin liecircn kết tagravei khoản điện tử
Bao gồm caacutec trường thocircng tin sau Tecircn chủ thẻ số thẻ
ngagravey phaacutet hagravenhngagravey hết hạn Ứng dụng của đối taacutec sẽ
kiểm tra caacutec thocircng tin sau
+ Số thẻ nhập coacute bắt đầu bằng 9704 hay khocircng Nếu
khocircng phải sẽ hiển thị thocircng baacuteo lỗi ldquoSố thẻ nhập khocircng
phải thẻ nội địa vui lograveng nhập lại thocircng tin số thẻrdquo
+ Tecircn chủ thẻ coacute kyacute tự đặc biệt hay khocircng Nếu coacute sẽ
hiển thị thocircng baacuteo lỗi rdquoTecircn chủ thẻ coacute kyacute tự đặc biệt vui
lograveng kiểm tra lạirdquo
+ Ngagravey phaacutet hagravenhngagravey hết hạn khocircng hợp lệ Nếu coacute
sẽ hiển thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn
khocircng hợp lệ vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu liecircn kết viacute điện tử
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
với thẻ ngacircn hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu liecircn kết
TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu liecircn kết tagravei khoản điện tử sang MB
Chuyển sang bước 4
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - MB thực hiện gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện
tử vagrave kegravem tạo Token (Số tiền nạp tối thiểu 3000 VNĐ
hoặc 10000 VNĐ tugravey từng ngacircn hagraveng) Chuyển sang
Napas để yecircu cầu nạp tiền vagraveo tagravei khoản điện tử
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
thẻtagravei khoản
TCPH Thẻ - Xaacutec thực thocircng tin thẻtagravei khoản của khaacutech hagraveng tại
TCPH như sau
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu tecircn chủ thẻ khocircng hợp lệ hiển thị thocircng baacuteo lỗi
ldquoTecircn chủ thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu ngagravey hết hạnngagravey phaacutet hagravenh khocircng hợp lệ Hiển
thị thocircng baacuteo lỗi ldquoNgagravey phaacutet hagravenhngagravey hết hạn khocircng
hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu thẻ khocircng ở trạng thaacutei hoạt động hiển thị thocircng
baacuteo lỗi ldquoThẻ khocircng hoạt động vui lograveng kiểm tra lạirdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Khởi tạo Token Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas
khởi tạo Token ứng thocircng tin thẻ giao dịch Vagrave trả kết
quả về MB giao dịch thagravenh cocircng qua đường IPN đồng
thời trả kết quả giao dịch trecircn trang của đối taacutec MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas khocircng khởi tạo Token vagrave trả kết quả về trang của
đối taacutec MB giao dịch khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB lưu caacutec thocircng
tin để sau nagravey thực hiện caacutec giao dịch khaacutec
)Thực hiện hạch toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
i) Link ewallet request
URL https[IPADDRESS][PORT]msewalletv10linkrequest
Method POST
Description Gửi yecircu cầu thực hiện liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
sourceNumber Số thẻsố tagravei khoản tugravey vagraveo
sourceType
- CARD
- ACCOUNT
- OTHERS
String M 20
nationalID Số CMNDThẻ CC String M 20
sourceName Tecircn thẻ String M 35
sourceType Kiểu ThẻTagravei khoảnkhaacutec String M -
dateOpenCard Ngagravey cấp String M -
mobile Số điện thoại String M 11
walletType Loại thẻ String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
gtresourceId Matilde liecircn kết String O
gtnapasKey Dugraveng cho luồng ngoagravei MB String O
gtdataKey Dugraveng cho luồng ngoagravei MB String O
ii) Link ewallter confirm
URL https[IPADDRESS][PORT]msewalletv10linkconfirm
Method POST
Description Thực hiện xaacutec nhận yecircu cầu liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtresourceId Matilde liecircn kết String M
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 255 Card status not valid
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 286 Card is disable
- 4080 Service not declare in config
- 4190 The source has been linked to another wallet
- 4191 The source has been linked to this wallet
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 4096 Customer is existed
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
500 Unknown error Please reach out to administrator
3 NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ TỪ THẺ LIEcircN KẾT
a Mocirc tả chung
- Khaacutech hagraveng coacute thể thực hiện nạp tiền vagraveo tagravei khoản điện tử theo caacutec higravenh thức sau
+ Chuyển tiền từ tagravei khoản khaacutec trong MB về tagravei khoản điện tử của khaacutech hagraveng
+ Chuyển tiền từ tagravei khoản ngacircn hagraveng khaacutec về tagravei khoản điện tử của khaacutech hagraveng
+ Sử dụng tiacutenh năng nạp tiền vagraveo tagravei khoản điện tử của khaacutech hagraveng qua thẻ đatilde liecircn kết trước
đoacute trecircn ứng dụng của đối taacutec
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
GIAO DỊCH NẠP TIỀN VAgraveO TAgraveI KHOẢN ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
NẠ
P T
IỀN
VAgrave
O T
AgraveI
KH
OẢ
N Đ
IỆN
TỬ
MB
QU
A N
AP
AS
Start
1 Lựa chọn tiacutenh năng
Nạp tiền TK điện tử
2 KH Nhập thocircng tin
Nạp tiền TK điện tử
3 Gửi yecircu cầu
Nạp tiền TK điện
tử
4 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử bằng Token
5 Gửi yecircu cầu nạp
tiền vagraveo TK điện
tử
6 Xaacutec thực
thocircng tin
Token
7 Gửi matilde OTP8 KH Nhập Matilde OTP
9 Xaacutec thực
OTP
11Nhận KQ12Trả thocircng baacuteo
KQ Thagravenh cocircng
13Trả thocircng baacuteo
KQ Thagravenh cocircngEnd 10 Hạch toaacuten
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng nạp
tiền TKĐT
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng nạp tiền vagraveo tagravei khoản
điện tử trecircn ứng dụng của đối taacutec Chuyển sang bước 2
để nhập thocircng tin nạp tiền
2 KH Nhập số tiền cần
nạp vagraveo TKĐT
Đối taacutec MB - Khaacutech hagraveng nhập số tiền cần nạp Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
khoản điện tử với thẻ ngacircn hagraveng khaacutec (Khocircng phải
ngacircn hagraveng MB)
3 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Đối taacutec MB - Đối taacutec gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
MB Thocircng tin đẩy sang MB bao gồm caacutec thocircng tin tối
thiểu sau
Số tiền cần nạp + Số WalletID
4 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
MB - Hệ thống MB kiểm tra thocircng tin
+ Nếu số tiền nạp nhỏ hơn số tiền tối thiểu trả về thocircng
baacuteo lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa trả về thocircng
baacuteo lỗi ldquoldquoSố tiền nạp lớn hơn số tiền tối thiểu Vui lograveng
kiểm tra lạirdquo
+ Nếu số tiền nạp lớn hơn số tiền tối đa1 giao dịch trả
về thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn hơn số tiền tối đa
trecircn 1 giao dịch vui lograveng thực hiện lạirdquo
+ Nếu thocircng tin nạp hợp lệ chuyển sang bước tiếp theo
- MB thực hiện gửi yecircu cầu nạp tiền vagraveo viacute điện tử qua
số token Chuyển sang Napas để yecircu cầu nạp tiền vagraveo tagravei
khoản điện tử Thocircng tin chuyển sang tối thiểu gồm caacutec
trường thocircng tin Số tiền nạp + Số token gắn với thẻ của
KH
5 Gửi yecircu cầu nạp tiền
vagraveo TKĐT
Napas - Napas gửi yecircu cầu nạp tiền vagraveo tagravei khoản điện tử sang
tổ chức phaacutet hagravenh Chuyển sang bước 6 để xaacutec thực
thocircng tin thẻtagravei khoản tại TCPH
6 Xaacutec thực thocircng tin
Token
Napas - Hệ thống Napas xaacutec thực thocircng tin Token như sau
+ Nếu số khocircng hợp lệ trả về thocircng baacuteo lỗi ldquoMatilde Token
khocircng hợp lệrdquo
+ Nếu thocircng tin hợp lệ Chuyển sang bước 7
7 Gửi matilde OTP TCPH Thẻ - Gửi matilde OTP Ngacircn hagraveng TCPH thực hiện gửi matilde OTP
cho khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
Chuyển sang bước 8 KH nhập matilde OTP
8 KH Nhập matilde OTP Khaacutech hagraveng - Khaacutech hagraveng nhập matilde OTP trecircn ứng dụng của đối taacutec
(Đối taacutec gọi trang của Napas để nhập matilde xaacutec thực OTP
do Napas cung cấp) Chuyển sang bước 9 gửi matilde OTP
sang cho TCPH
9 Xaacutec thực OTP TCPH Thẻ TCPH Thẻ thực hiện xaacutec thực matilde OTP
- Nếu matilde OTP khocircng hợp lệ TCPH thực hiện thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng hợp lệ vui lograveng kiểm tra lại matilde
xaacutec thựcrdquo
- Nếu nhập sai matilde OTP quaacute 03 lần hoặc quaacute thời gian
quy định hiển thị thocircng baacuteo lỗi vagrave kết thuacutec giao dịch
- Nếu matilde OTP hợp lệ
10 Hạch toaacuten TCPH Thẻ TCPH Thẻ thực hiện hạch toaacuten trừ tiền trong TK của KH
vagrave chuyển sang bước tiếp theo
11 Nhận kết quả Napas - Napas nhận kết quả giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng Hệ thống Napas trả
kết quả về MB giao dịch thagravenh cocircng qua đường IPN
đồng thời trả kết quả giao dịch trecircn trang của đối taacutec
MB
+ Nếu kết quả giao dịch khocircng thagravenh cocircng Hệ thống
Napas trả kết quả về trang của đối taacutec MB giao dịch
khocircng thagravenh cocircng
12 - MB nhận kết quả vagrave xử lyacute giao dịch
+ Nếu kết quả giao dịch thagravenh cocircng MB thực hiện hạch
toaacuten
Ghi nợ Tagravei khoản trung gian Napas chiều ACQ
Số tiền giao dịch + (Phiacute nếu coacute)
Ghi coacute tagravei khoản Viacute điện tử của khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
Số tiền giao dịch
Ghi coacute tagravei khoản VAT Số tiền phiacute (Nếu coacute)
13 Thocircng baacuteo kết quả tới
KH
Đối taacutec MB Đối taacutec MB hiển thị thocircng tin kết quả tới khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cash in ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashinrequest
Method POST
Description Gửi yecircu cầu Nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 11
amount Số tiền long M 13
fee Số tiền phiacute ruacutet Long O 13
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String M 50
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtresourceId Matilde giao dịch (Trả về trong trường hợp thẻ ngoagravei
MB)
String O
gtorderId Trong trường hợp Napas coacute vai trograve như
transactionId
String O
gtnapasKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
gtdataKey Trong trường hợp Napas key dugraveng để xaacutec định
thocircng tin tagravei khoản Napas
String O
ii) Cash in ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashinconfirm
Method POST
Description Xaacutec nhận nạp tiền vagraveo viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
requestId Request id String M 50
otp Matilde xaacutec thực OTP String M 10
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code String M
errorDesc SOA error code description Array
String
O
data Kết quả xử lyacute Object O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 000 SUCCESS
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 240 Limit has reached the maximum
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 2840 Resource does not exists
- 285 Invalid details
- 286 Card is disable
- 400 Account balance is insufficient
- 4013 Unacceptable transaction fee
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 500 Unknown error
- 502 Database error
- 284 ResourceId is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
4 RUacuteT TIỀN TỪ TAgraveI KHOẢN ĐIỆN TỬ VỀ TAgraveI KHOẢN LIEcircN KẾT
a Mocirc tả chung
- Cho pheacutep khaacutech hagraveng coacute thể thực hiện ruacutet tiền từ tagravei khoản viacute về tagravei khoản liecircn kết của khaacutech
hagraveng trước đoacute
- Hạn mức giao dịch
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
GIAO DỊCH RUacuteT TIỀN TỪ VIacute ĐIỆN TỬ VỀ TK QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS TCPH
GIA
O D
ỊCH
RUacute
T T
IỀN
TỪ
VIacute
ĐIỆ
N T
Ử V
Ề T
K Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Cashout từ Viacute điện tử
Về TK
2 KH Nhập thocircng tin
CashOut từ viacute điện tử
Về TK
3 Gửi yecircu cầu
CashOut từ viacute điện tử
Về TK
4 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
5 Gửi yecircu cầu
Truy vấn tecircn KH
Dựa vagraveo số Thẻ
6 Xaacutec thực
thocircng tin thẻ
Tagravei khoản
7 Trả về tecircn KH8Xaacutec thực tecircn
KH
9 Gửi matilde OTP10 Nhập matilde OTP
11 Gửi matilde OTP12 Xaacutec thực
Matilde OTP
13 MB Hạch toaacuten14Yecircu cầu
chuyển tiền qua Napas
15 Thực hiện
hạch toaacuten
16 Phản hồi kết quả17 MB phản hồi KQ18 Hiển thị kết quả
cho KHEnd
Y
N
Y
N
Y
N
Y
N
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng
Cashout
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng cashout từ viacute điện tử về
tagravei khoản thanh toaacuten trecircn ứng dụng của đối taacutec Chuyển
sang bước 2 để nhập số tiền cần cashout
2 Nhập thocircng tin Cashout Khaacutech hagraveng - Khaacutech hagraveng nhập số tiền cần ruacutet Ứng dụng của đối taacutec
sẽ kiểm tra caacutec thocircng tin sau
+ Số tiền nhập coacute đuacuteng định dạng hay khocircng Nếu
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
khocircng đuacuteng định dạng sẽ hiển thị thocircng baacuteo lỗi ldquo Số tiền
nhập khocircng đuacuteng định dạng vui lograveng kiểm tra lạirdquo
+ Số tiền nhỏ hơn số tiền tối thiểu Hiển thị thocircng baacuteo
lỗi ldquoSố tiền nạp nhỏ hơn số tiền tối thiểu Vui lograveng kiểm
tra lạirdquo
+ Số tiền lớn hơn số tiền tối đa Hiển thị thocircng baacuteo lỗi
ldquoSố tiền lớn hơn số tiền tối đa vui lograveng kiểm tra lạirdquo
Chuyển sang bước 3 gửi yecircu cầu ruacutet tiền từ viacute điện
tử vagraveo tagravei khoản thanh toaacuten của KH với thẻ ngacircn
hagraveng khaacutec (Khocircng phải ngacircn hagraveng MB)
3 Gửi yecircu cầu Cashout Đối taacutec - Đối taacutec gửi yecircu cầu ruacutet tiền từ tagravei khoản điện tử vagraveo tagravei
khoản thanh toaacuten của KH với thẻ ngacircn hagraveng khaacutec
(Khocircng phải ngacircn hagraveng MB)
- Thocircng tin gửi MB bao gồm caacutec thocircng tin WalletID +
Tecircn khaacutech hagraveng
4 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
MB - MB dựa vagraveo thocircng tin liecircn kết để tigravem ra số thẻ của
khaacutech hagraveng | Tecircn khaacutech hagraveng MB gửi yecircu cầu truy vấn
tecircn của KH sang Napas
5 Gửi yecircu cầu truy vấn
tecircn khaacutech hagraveng
Napas - Napas gửi yecircu cầu truy vấn tecircn của KH sang TCPH
(Gửi thocircng tin số thẻ sang TCPH)
6 Xaacutec thực thocircng tin TCPH - TCPH thẻ sẽ xaacutec thực thocircng tin thẻ của KH
+ Nếu số thẻ khocircng tồn tại hiển thị thocircng baacuteo lỗi ldquoSố
thẻ khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu số thẻ tồn tại truy vấn thocircng tin tecircn vagrave trả tecircn
khaacutech hagraveng về cho Napas
7 Trả về tecircn Khaacutech hagraveng Napas - Napas nhận thocircng tin kết quả truy vấn vagrave trả về cho
MB MB xaacutec thực lại tecircn khaacutech hagraveng
8 Xaacutec thực tecircn KH MB - MB xaacutec thực tecircn khaacutech hagraveng
+ Nếu tecircn KH khocircng giống với thocircng tin lưu tại MB sẽ
hiển thị thocircng baacuteo lỗi ldquoTecircn khaacutech hagraveng khocircng hợp lệ
Vui lograveng kiểm tra lạirdquo=gt Trả thocircng baacuteo về cho KH
+ Nếu tecircn KH giống với thocircng tin lưu tại MB chuyển
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
sang bước 9 để gửi matilde OTP cho khaacutech hagraveng
9 Gửi matilde OTP MB - MB Gửi matilde OTP cho khaacutech hagraveng qua số điện thoại KH
đăng kyacute với viacute điện tử
OTP cua Quy Khach la [otpvalue] Ma xac thuc giao
dich tren vi co hieu luc trong vong 2 phut QK TUYET
DOI khong cung cap OTP cho nguoi khac tranh bi lua
dao
10 Nhập matilde OTP Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực
11 Gửi matilde OTP Đối taacutec Đối taacutec gửi matilde xaacutec thực sang Ngacircn hagraveng để kiểm tra
thocircng tin xaacutec thực
12 Xaacutec thực OTP MB - MB xaacutec thực matilde OTP
+ Nếu matilde OTP khocircng hợp lệ Hiển thị thocircng baacuteo lỗi
ldquoMatilde OTP khocircng hợp lệ vui lograveng kiểm tra lạirdquo
+ Nếu matilde OTP hợp lệ Chuyển sang bước 13 hạch toaacuten
13 Hạch toaacuten MB - MB thực hiện hạch toaacuten cho khaacutech hagraveng
+ Ghi nợ TK Viacute điện tử của KH Số tiền giao dịch + Phiacute
(Nếu coacute)
+ Ghi coacute TK Napas tại MB Số tiền giao dịch
+ Ghi coacute TK VAT Số tiền giao dịch
14 Gửi yecircu cầu chuyển
tiền
Napas Napas gửi yecircu cầu chuyển tiền sang TCPH
15 TCPH Thực hiện hạch
toaacuten
TCPH TCPH nhận lệnh vagrave thực hiện hạch toaacuten sau đoacute trả kết
quả về cho Napas
16 Phản hồi kết quả Napas Napas nhận kết quả của TCPH vagrave phản hồi lại kết quả
cho MB
17 MB nhận kết quả MB MB nhận kết quả trả về từ Napas
+ Nếu kết quả khocircng thagravenh cocircng (Khocircng phải Timeout)
MB thực hiện revert lại giao dịch gốc cho KH
+ Nếu kết quả thagravenh cocircng MB trả thocircng baacuteo về cho đối
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
taacutec
18 Hiển thị kết quả Đối taacutec Đối taacutec hiển thị kết quả cho khaacutech hagraveng
c Luồng quy trigravenh tiacutech hợp
i) Cashout ewallet request
URL https[IPADDRESS][PORT]msewalletv10cashoutrequest
Method POST
Description Hỗ trợ ruacutet tiền từ viacute ra tagravei khoản liecircn kết
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceID Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
amount Số tiền long M -
bankCode Matilde ngacircn hagraveng( Bắt buộc aacutep dụng với
chuyển tiền ngoagravei MB)
String O -
fee Số tiền phiacute ruacutet Long O -
paymentDetails Thocircng tin them String M 140
transferType Higravenh thức chuyển
- Trong MB INHOUSE
- Qua citad IBPS
- Qua Napas FAST
String O -
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String O
gtreferenceNumber Matilde giao dịch (Trả về trong trường hợp thẻ
ngoagravei MB)
String O
ii) Cashout ewallet confirm
URL https[IPADDRESS][PORT]msewalletv10cashoutconfirm
Method POST
Description Xaacutec nhận yecircu cầu ruacutet tiền từ tagravei khoản viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtamount Số tiền long M
gtfee Số tiền phiacute Long O
gtreferenceNumber Matilde giao dịch String O
iii) ErrorCode
Ewallet ErrorCode
- 209 Amount is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 240 Limit has reached the maximum
- 243 Bank code is invalid
- 255 Card status not valid
- 272 Transaction value does not meet minimum limit set by bank
- 278 Wallet ID is invalid
- 2781 Wallet ID does not exists
- 284 Resource is invalid
- 2840 Resource does not exists
- 286 Card is disable
- 287 Transfer type is invalid
- 400 Account balance is insufficient
- 4058 Limit not setuped
- 4080 Service not declare in config
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- 4110 The number of transactions per day exceeded the limit
- 4111 The daily transaction amount exceeded the limit
- 414 Service isnt supported
- 418 Transaction is pending
- 429 Tranfer money is failed
- 448 Missing configuration information
- 451 The customer has not yet identified
- 4605 Card not registered for online payment
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
- 208 Branch is invalid
- 285 PaymentDetail is invalid
- 226 TransferType is invalid
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
5 HỦY LIEcircN KẾT THẺ NGOAgraveI MB
a Mocirc tả chung
- Hệ thống cho pheacutep khaacutech hagraveng thực hiện hủy liecircn kết đối với caacutec thẻ đatilde liecircn kết trước đoacute vagrave
khocircng cần xaacutec thực OTP
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
b Luồng quy trigravenh nghiệp vụ
i) Lưu đồ
GIAO DỊCH HỦY LIEcircN KẾT VAgraveO TK ĐIỆN TỬ MB QUA NAPAS
ĐỐI TAacuteCKHAacuteCH HAgraveNG MB NAPAS
GIA
O D
ỊCH
HỦ
Y L
IEcircN
KẾ
T V
AgraveO
TK
ĐIỆ
N T
Ử M
B Q
UA
NA
PA
S
Start
1 Lựa chọn tiacutenh năng
Hủy Liecircn kết TKĐT
2 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
3 Gửi yecircu cầu
Hủy Liecircn kết
TKĐT
4 Hủy Liecircn kết TKĐT
End
5 Nhận KQ
Hủy liecircn kết
TKĐT
6 Hiển thị KQ
Hủy liecircn kết
KTĐT
ii) Diễn giải lưu đồ
STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI
1 Lựa chọn tiacutenh năng hủy
liecircn kết tagravei khoản điện
tử
Khaacutech hagraveng - Khaacutech hagraveng lựa chọn tiacutenh năng hủy liecircn kết tagravei khoản
điện tử vagrave chuyển sang bước 2
2 Gửi yecircu cầu hủy liecircn
kết
Đối taacutec - Đối taacutec gửi yecircu cầu hủy liecircn kết sang MB Thocircng tin
gửi sang MB bao gồm caacutec thocircng tin
Số WalletID || Token ID ||Tecircn khaacutech hagraveng
3 Gửi yecircu cầu hủy liecircn
kết Token
MB - MB thực hiện gửi yecircu cầu hủy liecircn kết Token sang
MB Thocircng tin gửi sang Napas lagrave số token tương ứng
của khaacutech hagraveng (MB dựa vagraveo thocircng tin liecircn kết)
4 Hủy liecircn kết TKĐT Napas - Napas thực hiện hủy liecircn kết vagrave trả kết quả về MB
5 Nhận kết quả vagrave hủy
liecircn kết
MB MB nhận kết quả trả về từ Napas
+ Nếu hủy liecircn kết Token thagravenh cocircng MB thực hiện
hủy liecircn kết vagrave trả kết quả về cho khaacutech hagraveng
+ Nếu hủy liecircn kết Token khocircng thagravenh cocircng MB thực
hiện trả kết quả về cho khaacutech hagraveng lagrave hủy liecircn kết khocircng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
thagravenh cocircng
6 Hiển thị kết quả Đối taacutec - Đối taacutec hiển thị kết quả cho khaacutech hagraveng
+ Nếu thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn kết
thagravenh cocircngrdquo
+ Nếu khocircng thagravenh cocircng Hiển thị thocircng baacuteo ldquoHủy liecircn
kết khocircng thagravenh cocircng vui lograveng thực hiện lại saurdquo
c Luồng quy trigravenh tiacutech hợp
i) UnLink ewallet request
URL https[IPADDRESS][PORT] msewalletv10unlinkrequest
Method POST
Description Gửi yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input Body
Parameter Description Type MO Length
walletID Matilde viacute String M 50
resourceId Matilde liecircn kết String M 50
mobile Số điện thoại String M 20
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array String O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
gtmobile Số điện thoại String M
gtrequestId Matilde request String M
ii) UnLink ewallter confirm
URL https[IPADDRESS][PORT] msewalletv10unlinkconfirm
Method POST
Description Xaacutec nhận yecircu cầu hủy liecircn kết viacute
- Header info
Thamsố Giaacutetrị MO
Authorization Bearer lttokengt M
Content-Type applicationjson M
clientMessageId This is unique message id generated by service consumer
for each request Using GUID is recommended
M
transactionId The transaction ID Transaction id and bill id is key which
prevent duplicated transaction
M
- Input
Parameter Description Type MO
requestId Request id String M
otp Matilde xaacutec thực OTP String M
- Output
Output parameter Description Type MO
clientMessageId Client messageId String M
errorCode SOA error code (error code description) String M
errorDesc SOA error messages list Array
String
O
data Kết quả xử lyacute Object O
gtmobile Số điện thoại String M
iii) ErrorCode
Ewallet ErrorCode
- 204 National Identity is invalid
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
- 219 Mobile number is invalid
- 2190 Mobile number not match with MB info
- 231 Card number is invalid
- 237 PIN or OTP is incorrect or expired
- 267 Invalid cardholder name
- 278 Wallet ID is invalid
- 283 Card open date is invalid
- 284 Resource is invalid
- 4095 Customer is not exist
- 414 Service isnt supported
- 4192 The source not yet linked to wallet
- 4630 Invalid request
- 500 Unknown error
- 502 Database error
APIGEE ErrorCode
- 203 clientMessageId header is mandatory
- 203 Invalid Payload
- 203 Params is missing
- 402 Not found
- 402 Requested resource not found
- 240 Too many requests received in a short span of time
- 240 Exceeded developer quota
- 002 Gateway Timeout
- 500 Internal Error Server
- 500 Unknown error Please reach out to administrator
6 THANH TOAacuteN DỊCH VỤ
a Mocirc tả chung
Khaacutech hagraveng sau khi thực hiện mở tagravei khoản điện tử thigrave được pheacutep thanh toaacuten trecircn tagravei khoản điện tử
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
Hạn mức
Nạp tiền Thanh toaacuten Ruacutet tiền
Level 1 Level 2 Level 3 Level 1 Level 2 Level 3 Level1 Level 2 Level 3
Số tiền giao
dịch tối
thiểu1 GD
10000 10000 10000 10000 10000 10000
- 10000 10000
Số tiền giao
dịch tối đa1
GD
1000000
0 10000000
1000000
00
1000000
0
1000000
0
10000000
0
-
100000
00
10000000
0
Số tiền giao
dịch tối đa1
ngagravey
5000000
0 50000000
1000000
000
5000000
0
5000000
0
10000000
00
-
500000
00
1000000
000
Số tiền giao
dịch tối đa1
thaacuteng
unlimited unlimited unlimited 5000000
0
5000000
0 unlimited
-
500000
00 unlimited
Số lần tối
đangagravey 20 20 20 20 20 20
- 20 20
b Luồng quy trigravenh nghiệp vụ
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
QUY TRIgraveNH THANH TOAacuteN TREcircN APP ĐỐI TAacuteC
APP ĐỐI TAacuteCKHAacuteCH HAgraveNG HỆ THỐNG MB
QU
Y T
RIgraveN
H T
HA
NH
TO
AacuteN
TR
EcircN
AP
P Đ
ỐI
TAacute
C
Start
1 Khaacutech hagraveng lựa chọn tiacutenh
năng thanh toaacuten hagraveng hoacutea
2 Đối taacutec đẩy thocircng
thanh toaacuten sang MB
End
3 MB xaacutec thực
thocircng tin
31 MB gửi OTP cho KH4Khaacutech hagraveng nhập matilde OTP
Y
5 Chuyển thocircng tin OTP6 MB xaacutec thực
OTP
7MB Hạch
toaacuten
Y
9Hiển thị kết quả 8 Nhận kết quả
N
N
c Luồng quy trigravenh tiacutech hợp
STT Nội dung Người thực
hiện
Diễn giải
Bước 1 Khaacutech hagraveng lựa
chọn thanh toaacuten
hagraveng hoacutea
Khaacutech hagraveng Khaacutech hagraveng đăng nhập vagraveo App của ĐỐI TAacuteC vagrave lựa
chọn tiacutenh năng thanh toaacuten hagraveng hoacutea
+ Hệ thống ĐỐI TAacuteC cho pheacutep khaacutech hagraveng nhập thocircng
tin thanh toaacuten
(Bao gồm Số tiền ndash Nội dung thanh toaacuten)
+ TransType Loại giao dịch lagrave giao dịch thanh toaacuten
hagraveng hoacutea
+ MerchantID matilde merchant tương ứng
+ Matilde hoacutea đơn
Lưu yacuteHệ thống ĐỐI TAacuteC chỉ cho pheacutep khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
chuyển khi đatilde liecircn kết gắn nguồn tagravei khoản
Bước 2 Chuyển thocircng
tin thanh toaacuten
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC kiểm tra thocircng tin của khaacutech hagraveng
trước khi gửi sang MB
- Kiểm tra số tiền chuyển
+ Nếu số tiền khocircng đuacuteng định dạng sẽ hiển thị thocircng
baacuteo ldquoSố tiền khocircng đuacuteng định dạng vui lograveng nhập lại số
tiềnrdquo
+ Nếu số tiền nhỏ hơn số tiền tối thiểu của 1 giao dịch
sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch nhỏ hơn số
tiền tối thiểu1 giao dịch vui lograveng nhập lại số tiền rdquo
+ Nếu số tiền lớn hơn số tiền giao dịch tối đa của 1
giao dịch sẽ hiển thị thocircng baacuteo lỗi ldquoSố tiền giao dịch lớn
hơn số tiền tối đa1 giao dịch vui lograveng nhập lại số tiềnrdquo
+ Nếu thocircng tin số tiền hợp lệ chuyển sang bước tiếp
theo
- Kiểm tra thocircng tin nội dung
+ Nếu trường nội dung để trống sẽ hiển thị thocircng baacuteo
lỗi ldquoTrường nội dung đang để trống vui lograveng nhập lại
trường nội dungrdquo
+ Nếu trường nội dung hợp lệ chuyển sang bước tiếp
theo
- Thocircng tin ĐỐI TAacuteC đẩy sang MB bao gồm caacutec trường
thocircng tin sau
+ RequestID cho bản ghi duy nhất
+ WALLET ID (Gắn vớ`i Khaacutech hagraveng)
+ Họ vagrave tecircn người chuyển tiền
+ Matilde hoacutea đơn
+ Matilde merchant
+ Số tagravei khoản người nhận 050-11-66868-88-8
+ Tecircn chủ tagravei khoản nhận tiền WILAD SOLUTIONS
+ Số tiền thanh toaacuten
+ Nội dung thanh toaacuten
Chuyển sang bước 3
Bước 3 MB xaacutec thực Hệ thống MB Hệ thống MB tiếp nhận thocircng tin thanh toaacuten vagrave kiểm tra
thocircng tin thanh toaacuten
+ Nếu thocircng tin WALLET ID của người chuyển khocircng
tồn tại Sẽ trả về thocircng baacuteo lỗi ldquo Khaacutech hagraveng chưa liecircn
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
kết vui lograveng thực hiện liecircn kếtrdquo
+ Nếu WALLET ID vagrave tecircn người chuyển khocircng đuacuteng
theo lưu ở hệ thống MB trả thocircng baacuteo lỗi ldquoThocircng tin
khaacutech hagraveng khocircng đuacutengrdquo
+ Nếu số tagravei khoản người nhận khocircng tồn tại trong danh
saacutech tagravei khoản nhận của ĐỐI TAacuteC được lưu trong hệ
thống MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu số tagravei khoản nagravey vagrave tecircn chủ tagravei khoản khocircng đuacuteng
MB trả thocircng baacuteo lỗi vagrave dừng lại
+ Nếu thocircng tin hợp lệ hệ thống MB gửi matilde OTP cho
khaacutech hagraveng (Qua số điện thoại KH đăng kyacute với NH) vagrave
trả thocircng baacuteo tới ĐỐI TAacuteC để ĐỐI TAacuteC chuyển đến
magraven higravenh nhập matilde OTP
Cuacute phaacutep SMS gửi OTP cho KH OTP của Quy khach
la OTPvalue Ma xac thuc giao dich tren ĐỐI TAacuteC co
hieu luc trong vong 2 phut QK TUYET DOI khong cung
cap OTP cho nguoi khac tranh bi lua dao
Bước 4 Nhập matilde xaacutec
thực
Khaacutech hagraveng Khaacutech hagraveng nhập matilde xaacutec thực OTP
Bước 5 Chuyển thocircng
tin OTP
ĐỐI TAacuteC Hệ thống ĐỐI TAacuteC Verify thocircng tin trước khi gửi sang
MB để xaacutec thực
+ Nếu khaacutech hagraveng khocircng nhập matilde OTP hệ thống sẽ
hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực để trống vui lograveng
nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực khocircng đuacuteng định dạng (Khaacutec 8 số)
hệ thống sẽ hiển thị thocircng baacuteo lỗi ldquoMatilde xaacutec thực khocircng
đuacuteng định dạng vui lograveng nhập lại matilde xaacutec thựcrdquo
+ Nếu matilde xaacutec thực hợp lệ =gt Chuyển sang NH để xaacutec
thực
Chuyển sang bước 6
Bước 6 Xaacutec thực OTP Hệ thống MB Hệ thống MB xaacutec thực thocircng tin
+ Nếu matilde xaacutec thực khocircng hợp lệ sẽ hiển thị thocircng baacuteo
lỗi ldquoMatilde xaacutec thực khocircng chiacutenh xaacutec vui lograveng thực hiện lại
giao dịchrdquo
+ Nếu matilde xaacutec thực hết thời hạn hiệu lực sẽ hiển thị
thocircng baacuteo lỗi ldquoMatilde xaacutec thực hết hiệu lực vui lograveng thực
hiện lại giao dịchrdquo
+ Nếu matilde xaacutec thực hợp lệ Chuyển sang bước 7 MB
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng
hạch toaacuten
Chuyển sang bước 7
Bước 7 MB Hạch toaacuten Hệ thống MB MB kiểm tra thocircng tin
- Kiểm tra thocircng tin số tiền giao dịch
+ Nếu số tiền giao dịch gt Số dư của TK sẽ hiển thị
thocircng baacuteo lỗi ldquoSố dư tagravei khoản khocircng đủ để thực hiện
giao dịch vui lograveng kiểm tra lại TKrdquo
+ Nếu số tiền giao dịch gt Tổng số tiền giao dịch trong 1
ngagravey của tagravei khoản hệ thống sẽ hiển thị thocircng baacuteo lỗi
ldquoTổng số tiền giao dịch lớn hơn tổng số tiền giao dịch
trong ngagravey vui lograveng kiểm tra lạirdquo
- Hệ thống MB thực hiện hạch toaacuten theo luồng hạch toaacuten
sau
Ghi nợ TK KH chuyển Số tiền giao dịch + Phiacute (Nếu
coacute)
Ghi coacute TK đến của merchant Số tiền giao dịch
Ghi coacute TK Phiacute (Nếu coacute) Số tiền phiacute
=gt MB hạch toaacuten xong Chuyển sang bước 8
Bước 8 Nhận kết quả ĐỐI TAacuteC ĐỐI TAacuteC nhận kết quả trả về từ MB vagrave hiển thị kết quả
giao dịch cho khaacutech hagraveng
+ Thocircng baacuteo lỗi sẽ hiển thị thocircng baacuteo lỗi chi tiết cho
khaacutech hagraveng
+ Thocircng baacuteo giao dịch thagravenh cocircng tới khaacutech hagraveng