nghiỆp vỤ kẾt nỐi vÍ ĐiỆn t mb

46
NGHIP VKT NỐI VÍ ĐIỆN TMB

Upload: others

Post on 28-Nov-2021

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 2: NGHIỆP VỤ KẾT NỐI VÍ Đ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

Page 3: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 4: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 5: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 6: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 7: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 8: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 9: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 10: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 11: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 12: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 13: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 14: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 15: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 16: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 17: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 18: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 19: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 20: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 21: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 22: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 23: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 24: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 25: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 26: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 27: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 28: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 29: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 30: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 31: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 32: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 33: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 34: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 35: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 36: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 37: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 38: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 39: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 40: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 41: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

- 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

Page 42: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 43: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 44: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 45: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T MB

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

Page 46: NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN T 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