NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN TỬ MB

NGHIỆP VỤ KẾT NỐI VÍ ĐIỆN TỬ MB MỤC LỤC ĐĂNG KÝ MỞ TÀI KHOẢN ĐIỆN TỬ a Mô tả chung b Luồng quy trình nghiệp vụ c Luồng quy trình tích hợp 10 LIÊN KẾT THẺ NGOÀI MB VỚI TÀI KHOẢN ĐIỆN TỬ .16 a Mô tả chung .16 b Luồng quy trình nghiệp vụ 16 c Luồng quy trình tích hợp 19 NẠP TIỀN VÀO TÀI KHOẢN ĐIỆN TỬ TỪ THẺ LIÊN KẾT .23 a Mô tả chung .23 b Luồng quy trình nghiệp vụ 23 c Luồng quy trình tích hợp 27 RÚT TIỀN TỪ TÀI KHOẢN ĐIỆN TỬ VỀ TÀI KHOẢN LIÊN KẾT .30 a Mô tả chung .30 b Luồng quy trình nghiệp vụ 30 c Luồng quy trình tích hợp 34 HỦY LIÊN KẾT THẺ NGOÀI MB 37 a Mô tả chung .37 b Luồng quy trình nghiệp vụ 38 c Luồng quy trình tích hợp 39 THANH TOÁN DỊCH VỤ .41 a Mô tả chung .41 b Luồng quy trình nghiệp vụ 42 c Luồng quy trình tích hợp 43 ĐĂNG KÝ MỞ TÀI KHOẢN ĐIỆN TỬ a Mô tả chung - Đối với khách hàng : Cho phép mở tài khoản ví điện tện tử khách hàng gắn với kênh thực từ đối tác - Đối với khách hàng tồn hệ thống MB : Cho phép gắn tài khoản tốn tồn hệ thống MB với thơng tin điện tử khách hàng b Luồng quy trình nghiệp vụ i) Lưu đồ quy trình nghiệp vụ LUỒNG QUY TRÌNH TẠO TÀI KHOẢN THANH TỐN MBBANK ĐỐI TÁC KHÁCH HÀNG GATEWAY MB T24 Đăng nhập Lựa chọn tính Đăng ký tài khoản Nhập thơng tin giấy tờ tùy thân 3.1 Hiển thị thông tin khách hàng tồn WALLET ID 3.Kiểm tra khách hàng có WALLET ID hay chưa? YES NO Thực eKYC 3.2.u cầu eKYC Thơng tin eKYC có hợp lệ không ? 5.2.Trả thông báo lỗi cho khách hàng Kiểm tra xem khách hàng có wallet ID hay chưa? 5.1 Gửi thông tin CMND SDT cho MB NO 6.3 Nhận thơng tin tài khoản ví kết thúc 6.2 Lưu lại thông tin WALLET ID thông báo cho KH YES 6.1 Gửi thông tin WALLET ID NO Mở WALLETID Gửi thông tin khách hàng chưa có wallet ID 8.1 Gửi lại WALLET ID, số CMND SDT 8.2 Kiểm tra KH có CODE MB chưa ? YES Kiếm tra số điện thoại KH đăng ký có khớp với SDT DNP gửi hay không ? 10 Kiếm tra KH có tk MB chưa ? YES NO 11 Gửi yêu cầu tạo tk code cho KH NO 12 Gửi OTP cho KH 13 Nhập OTP OTP có hợp lệ? END 18 Thông báo kết cho khách hàng YES NO NO 17 Phản hồi kết Phase 16 Lưu lại thông tin token ID gắn với user ii) Diễn giải lưu đồ 15 Lưu WALET ID gắn với tài khoản KH 14 Tạo Code TK cho KH STT Bước NỘI DUNG Đăng nhập App + đăng ký tài khoản NGƯỜI THỰC HIỆN Khách hàng Diễn giải Khách hàng đăng nhập vào App đối tác ĐỐI TÁC (UserName / Mật khẩu) Khách hàng lựa chọn tính đăng ký TK khách hàng MB Bước Nhập thông tin giấy tờ tùy thân Khách hàng ĐỐI TÁC Khách hàng nhập thông tin giấy tờ tùy thân: CMND/CCCD - CMND: Bao gồm CMND thường (9 12 số) CMND Sỹ quan - CCCD: Có độ dài 12 số Bước Kiểm tra khách hàng tồn WALLET ID hay chưa ĐỐI TÁC ĐỐI TÁC kiểm tra thông tin khách hàng tồn wallet ID hay chưa: - Nếu có WALLET ID chuyển sang bước 3.1:Gửi thơng tin WALLET ID Cho ĐỐI TÁC - Nếu chưa có WALLET ID chuyển sang bước 3.2: Yêu cầu eKYC Khách hàng nhận thơng tin tài khoản ví KH kết thúc Bước 3.1 Nhận thơng tin tài khoản ví kết thúc Khách hàng Bước 3.2 Yêu cầu eKYC ĐỐI TÁC Đối tác ĐỐI TÁC gọi đến SDK MB đối tác MB cung cấp thực eKYC khách hàng Bước Thực eKYC Khách hàng Khách hàng thực eKYC bao gồm: - Chụp CMND : Mặt trước mặt sau - Chụp chân dung: Bên trái, bên phải - Nhấn nút tiếp tục Bước Kiểm tra thông tin eKYC ĐỐI TÁC Hệ thống ĐỐI TÁC thực Config tham số kiểm tra tính hợp lệ - Khn mặt khách hàng có giống với khn mặt chụp giấy tờ tùy thân khơng? - Thơng tin giấy tờ tùy thân có với thông tin giấy tờ Tùy thân KH hệ thống ĐỐI TÁC hay không? - Các thông tin khác khách hàng như: Ngày cấp, ngày sinh có hợp lệ hay khơng? ảnh chụp có bị lóa hay khơng? Giấy tờ tùy thân bị cắt góc, => Nếu thông tin hợp lệ: Chuyển sang bước 5.1 để gửi thông tin cho MB => Nếu thông tin không hợp lệ: chuyển sang bước 5.2 Trả thông báo lỗi tương ứng cho khách hàng Bước 5.1 Gửi thông tin cho MB ĐỐI TÁC ĐỐI TÁC gửi thông tin: - CMND - SDT Sang hệ thống MB Bước Kiếm tra KH có walletID hay chưa MB MB kiểm tra thơng tin CMND có gắn với WALLET ID khách hàng hay khơng: - Nếu có chuyển sang bước 6.1: Gửi thông tin WALLET ID Bước 6.1 Gửi thông tin WALLET ID MB khách hàng chưa có WALLET ID MB gửi thông tin: - Bước 6.2 Lưu lại thông tin WALLET ID thông báo cho khách hàng ĐỐI TÁC Nếu không chuyển sang bước 7: Gửi thông tin CMND - WALLET ID tương ứng ĐỐI TÁC nhận thông tin WALLET ID từ MB lưu lại thông tin hệ thống: - CMND - WALLET ID Sau gửi thơng báo cho khách hàng: “Q khách có tài khoản ví ĐỐI TÁC, vui lịng tiếp tục sủ dụng dịch vụ” Bước 6.3 Nhận thông tin tài khoản ví kết thúc Khách hàng Khách hàng nhận thơng tin tài khoản ví KH kết thúc Bước Gửi thơng tin KH chưa có WALLET ID GATEWAY MB MB gửi thơng tin KH chưa có WALLET ID MB cho ĐỐI TÁC Bước Tạo WALLET ID ĐỐI TÁC ĐỐI TÁC tạo WALLET ID: - Bước 8.1 Gửi thông tin WALLET ID cho MB ĐỐI TÁC Duy hệ thống - Gắn với CMND KH ĐỐI TÁC gửi thông tin: - WALLET ID Bước 8.2 Kiểm tra KH có Code MB? GateWay MB Số CMND - Số điện thoại Hệ thống MB kiểm tra khách hàng xem có Code KH MB hay chưa? Dựa vào thông tin CMND đối tác gửi sang - Nếu KH có Code MB: Chuyển sang bước Kiểm tra xem số điện thoại KH có khớp với SDT ĐỐI TÁC gửi hay khơng ? - Nếu KH chưa có Code MB: Chuyển sang bước 11 để yêu cầu tạo code tài khoản cho khách hàng Bước Kiểm tra số điện thoại KH khách hàng có trùng với SDT lưu hệ thống MB không GATEWAY MB Hệ thống MB kiểm tra thơng tin ĐỐI TÁC gửi có trung khớp với thông tin KH lưu MB hay không: - Nếu SDT KH trùng với SDT lưu hệ thống core MB => chuyển sang bước 10: Kiểm tra KH có tài khoản MB hay chưa - Nếu SDT KH không trùng với SDT lưu hệ thống core MB => Gửi báo lỗi cho ĐỐI TÁC “Số điện thoại đăng ký không trùng với SDT lưu MB” kết Bước 10 Kiểm tra KH có TK MB? T24 MB thúc Hệ thống MB kiểm tra khách hàng xem có TK KH MB hay chưa? Lựa chọn tài khoản theo quy tắc sau: - Nếu KH có tài khoản => chọn tài khoản tài khoản liên kết - Nếu KH có Tài khoản vơ danh MB: Sector: 1911 Category 4202 Sub 713  Chuyển tk sang: Sector 1917 Category 1001 Sub 713 - Nếu KH có tài khoản định danh MB: chọn tài khoản tài khoản liên kết - Nếu KH có nhiều tài khoản: + Chọn tài khoản có số dư lớn để liên kết + Nếu tài khoản số dư cao tk vô danh chọn tài khoản định danh có số dư lớn +Nếu số dư tài khoản => chọn tài khoản ngẫu nhiên Chuyển sang bước 12: Gưi yêu cầu tạo WALLET ID - Nếu KH chưa có Tài khoản MB: Chuyển sang bước 14 để yêu cầu tạo tài khoản cho khách hàng Bước 11 Gửi yêu cầu tạo TK GATEWAY MB Gateway MB gửi yêu cầu tạo code tk cho KH Bước 12 Gửi mã OTP cho khách hàng Hệ thống GateWay MB tạo OTP đến số điện thoại cho khách hàng: GateWay MB - Nếu tạo Code khách hàng mới: Gửi OTP đến số điện thoại khách hàng đăng ký App ĐỐI TÁC - Nếu tạo TK: Gửi OTP đến số điện thoại khách hàng đăng ký MB trước + Nếu thơng tin Số điện thoại khách hàng gửi sang, mà khách hàng có MB khác số điện thoại khách hàng đăng ký MB (Trên hệ thống T24), MB trả thông báo lỗi cho khách hàng “Số điện thoại đăng ký không với số điện thoại đăng ký ngân hàng, vui lòng kiểm tra lại”; + Nếu thông tin số điện thoại khách hàng guiwe sang mà trùng thông tin số điện thoại đăng ký MB, MB gửi OTP cho khách hàng OTP cua Quy Khach la: [otpvalue] Ma xac thuc giao dich tren vi co hieu luc vong phut QK TUYET DOI khong cung cap OTP cho nguoi khac tranh bi lua dao! Bước 13 KH nhập mã OTP Khách hàng Khách hàng nhập mã OTP đối tác gửi mã OTP sang MB để kiểm tra Kiểm tra mã OTP Hệ thống MB Hệ thống MB kiểm tra thông tin mã OTP - Nếu thông tin mã OTP không hợp lệ, hiển thị thông báo lỗi “Mã xác thực không hợp lệ”; - Nếu thông tin mã OTP nhập sai lần, hiển thị thông báo lỗi “Bạn nhập sai lần, vui lòng thực lại giao dịch sau” - Nếu thông tin hợp lệ: Chuyển sang bước 11 tạo Code TK cho khách hàng Bước 14 Tạo Code TK cho KH Hệ thống MB - Hệ thống ĐỐI TÁC gửi yêu cầu đăng ký tài khoản sang Ngân hàng bao gồm trường thông tin sau: + Họ tên khách hàng + Số CMND + Ngày tháng năm sinh + Giới tính + Quê quản + Nơi thường trú + Ngày cấp, nơi cấp + Địa email + Số điện thoại - Hệ thống MB thực Tạo Code TK khách hàng theo nguyên tắc sau: KH có code MB =>Hệ thống MB gửi yêu cầu tạo tài khoản cho khách hàng o Mở TK KH với Category 1001 o Channel: [Đối tác tương ứng] KH chua có code MB =>Hệ thống MB gửi yêu cầu tạo Code tk cho khách hàng - - Thông tin Client: Các thông tin đối tác truyền sang lưu ý o Thông tin Sector 1917 o company book Hội sở Thông tin Tài khoản: category 1001, company book Hội sở ▪ Channel: [Tương ứng với đối tác] MB gửi thông báo kết mở tài khoản thành công qua email cho khách hàng; Bước 15 Lưu lại wallet ID gắn với tài khoản KH Gateway MB MB lưu lại wallet ID gắn với tài khoản khách hàng dùng cho DV ĐỐI TÁC vào hệ thống Bước 16 Lưu lại thông tin wallet ID gắn với user ĐỐI TÁC ĐỐI TÁC lưu lại wallet ID tương ứng với CMND user hệ thống Bước 17 Phản hồi kết Hệ thống MB Thông báo kết cho khách hàng + MB trả kết thông báo lỗi, ĐỐI TÁC phản hồi kết lỗi tương ứng + MB tạo kết thành cơng • MB tạo liên kết với ĐỐI TÁC tài khoản liên kết với dịch vụ eMB MB ĐỐI TÁC thông báo dịch vụ mở thành công tới khách hàng c Luồng quy trình tích hợp i) Create ewallet request URL https://[IP/DOMAIN]:[PORT]/ms/ewallet/v1.1/register/request Method POST Description Gửi yêu cầu đăng kí ví điện tử - Header info Thamsố Giátrị M/O Authorization Bearer M Content-Type application/json M clientMessageId This is unique message id generated by service consumer M for each request Using GUID is recommended transactionId The transaction ID Transaction id and bill id is key which M prevent duplicated transaction - Input Body Parameter Description Type M/O Length walletID Mã ví String M 50 khơng định dạng hiển thị thông báo lỗi “ Số tiền nhập không định dạng, vui lòng kiểm tra lại”; + Số tiền nhỏ số tiền tối thiểu? Hiển thị thông báo lỗi “Số tiền nạp nhỏ số tiền tối thiểu, Vui lòng kiểm tra lại”; + Số tiền lớn số tiền tối đa? Hiển thị thông báo lỗi “Số tiền lớn số tiền tối đa, vui lòng kiểm tra lại”;  Chuyển sang bước 3, gửi yêu cầu rút tiền từ ví điện tử vào tài khoản tốn KH với thẻ ngân hàng khác (Khơng phải ngân hàng MB) Gửi yêu cầu Cashout Đối tác - Đối tác gửi yêu cầu rút tiền từ tài khoản điện tử vào tài khoản toán KH với thẻ ngân hàng khác (Không phải ngân hàng MB) - Thông tin gửi MB bao gồm thông tin : WalletID + Tên khách hàng; Gửi yêu cầu truy vấn MB tên khách hàng - MB dựa vào thơng tin liên kết để tìm số thẻ khách hàng | Tên khách hàng MB gửi yêu cầu truy vấn tên KH sang Napas; Gửi yêu cầu truy vấn Napas (Gửi thông tin số thẻ sang TCPH) tên khách hàng Xác thực thông tin - Napas gửi yêu cầu truy vấn tên KH sang TCPH TCPH - TCPH thẻ xác thực thông tin thẻ KH + Nếu số thẻ không tồn tại, hiển thị thông báo lỗi “Số thẻ không hợp lệ, vui lòng kiểm tra lại”; + Nếu số thẻ tồn tại, truy vấn thông tin tên trả tên khách hàng cho Napas Trả tên Khách hàng Napas - Napas nhận thông tin kết truy vấn trả cho MB MB xác thực lại tên khách hàng Xác thực tên KH MB - MB xác thực tên khách hàng: + Nếu tên KH không giống với thông tin lưu MB hiển thị thông báo lỗi, “Tên khách hàng không hợp lệ, Vui lịng kiểm tra lại”=> Trả thơng báo cho KH + Nếu tên KH giống với thông tin lưu MB, chuyển sang bước để gửi mã OTP cho khách hàng Gửi mã OTP MB - MB Gửi mã OTP cho khách hàng qua số điện thoại KH đăng ký với ví điện tử; OTP cua Quy Khach la: [otpvalue] Ma xac thuc giao dich tren vi co hieu luc vong phut QK TUYET DOI khong cung cap OTP cho nguoi khac tranh bi lua dao! 10 Nhập mã OTP Khách hàng Khách hàng nhập mã xác thực 11 Gửi mã OTP Đối tác Đối tác gửi mã xác thực sang Ngân hàng để kiểm tra thông tin xác thực 12 Xác thực OTP MB - MB xác thực mã OTP + Nếu mã OTP không hợp lệ, Hiển thị thông báo lỗi “Mã OTP khơng hợp lệ, vui lịng kiểm tra lại”; + Nếu mã OTP hợp lệ, Chuyển sang bước 13 hạch toán 13 Hạch toán MB - MB thực hạch toán cho khách hàng: + Ghi nợ TK Ví điện tử KH: Số tiền giao dịch + Phí (Nếu có) + Ghi có TK Napas MB: Số tiền giao dịch + Ghi có TK VAT : 14 Gửi yêu cầu chuyển Số tiền giao dịch Napas Napas gửi yêu cầu chuyển tiền sang TCPH TCPH TCPH nhận lệnh thực hạch tốn: sau trả kết tiền 15 TCPH Thực hạch toán 16 Phản hồi kết quả cho Napas Napas Napas nhận kết TCPH phản hồi lại kết cho MB 17 MB nhận kết MB MB nhận kết trả từ Napas : + Nếu kết không thành công (Không phải Timeout): MB thực revert lại giao dịch gốc cho KH + Nếu kết thành công, MB trả thông báo cho đối tác 18 Đối tác Hiển thị kết Đối tác hiển thị kết cho khách hàng c Luồng quy trình tích hợp i) Cashout ewallet request URL https://[IPADDRESS]:[PORT]/ms/ewallet/v1.0/cashout/request Method POST Description Hỗ trợ rút tiền từ ví tài khoản liên kết - Header info Thamsố Giátrị M/O Authorization Bearer M Content-Type application/json M clientMessageId This is unique message id generated by service consumer for each request Using GUID is recommended M transactionId The transaction ID Transaction id and bill id is key which prevent duplicated transaction M - Input Parameter Description Type M/O Length walletID Mã ví String M 50 resourceID Mã liên kết String M 50 mobile Số điện thoại String M 20 amount Số tiền long M - bankCode Mã ngân hàng( Bắt buộc áp dụng với chuyển tiền ngồi MB) String O - fee Số tiền phí rút Long O - paymentDetails Thông tin them String M 140 transferType Hình thức chuyển String O - - Trong MB: INHOUSE - Qua citad: IBPS - Qua Napas: FAST - Output Output parameter Description Type M/O clientMessageId Client messageId String M errorCode SOA error code (error code description) String M errorDesc SOA error messages list Array String O data Kết xử lý Object O >mobile Số điện thoại String M >requestId Mã request String O >referenceNumber Mã giao dịch (Trả trường hợp thẻ MB) String O ii) Cashout ewallet confirm URL https://[IPADDRESS]:[PORT]/ms/ewallet/v1.0/cashout/confirm Method POST Description Xác nhận yêu cầu rút tiền từ tài khoản ví - Header info Thamsố Giátrị M/O Authorization Bearer M Content-Type application/json M clientMessageId This is unique message id generated by service consumer for each request Using GUID is recommended M transactionId The transaction ID Transaction id and bill id is key which prevent duplicated transaction M - Input Parameter Description Type M/O requestId Request id String M otp Mã xác thực OTP String M Output parameter Description Type M/O clientMessageId Client messageId - Output String M errorCode SOA error code (error code description) String M errorDesc SOA error messages list Array String O data Kết xử lý >amount Object O Số tiền long M >fee Số tiền phí Long O >referenceNumber Mã 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 - 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! Resource is invalid - 4110 The number of transactions per day exceeded the limit - 4111 The daily transaction amount exceeded the limit - 414 Service isn't 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 HỦY LIÊN KẾT THẺ NGỒI MB a Mơ tả chung - Hệ thống cho phép khách hàng thực hủy liên kết thẻ liên kết trước khơng cần xác thực OTP b Luồng quy trình nghiệp vụ i) Lưu đồ GIAO DỊCH HỦY LIÊN KẾT VÀO TK ĐIỆN TỬ MB QUA NAPAS GIAO DỊCH HỦY LIÊN KẾT VÀO TK ĐIỆN TỬ MB QUA NAPAS ĐỐI TÁC KHÁCH HÀNG MB NAPAS Start Gửi yêu cầu Hủy Liên kết TKĐT Lựa chọn tính Hủy Liên kết TKĐT Hiển thị KQ Hủy liên kết KTĐT End Gửi yêu cầu Hủy Liên kết TKĐT Hủy Liên kết TKĐT Nhận KQ Hủy liên kết TKĐT ii) Diễn giải lưu đồ STT NỘI DUNG NGƯỜI THỰC HIỆN DIỄN GIẢI Lựa chọn tính hủy Khách hàng - Khách hàng lựa chọn tính hủy liên kết tài khoản liên kết tài khoản điện điện tử chuyển sang bước tử Gửi yêu cầu hủy liên Đối tác kết - Đối tác gửi yêu cầu hủy liên kết sang MB Thông tin gửi sang MB bao gồm thông tin: Số WalletID || Token ID ||Tên khách hàng Gửi yêu cầu hủy liên MB - MB thực gửi yêu cầu hủy liên kết Token sang MB Thông tin gửi sang Napas số token tương ứng kết Token khách hàng (MB dựa vào thông tin liên kết) Hủy liên kết TKĐT Napas Nhận kết hủy MB liên kết - Napas thực hủy liên kết trả kết MB MB nhận kết trả từ Napas: + Nếu hủy liên kết Token thành công: MB thực hủy liên kết trả kết cho khách hàng + Nếu hủy liên kết Token không thành công: MB thực trả kết cho khách hàng hủy liên kết không thành công Hiển thị kết - Đối tác hiển thị kết cho khách hàng: Đối tác + Nếu thành công: Hiển thị thông báo “Hủy liên kết thành công” + Nếu không thành công: Hiển thị thông báo “Hủy liên kết khơng thành cơng, vui lịng thực lại sau” c Luồng quy trình tích hợp i) UnLink ewallet request URL https://[IPADDRESS]:[PORT]/ ms/ewallet/v1.0/unlink/request Method POST Description Gửi yêu cầu hủy liên kết ví - Header info Thamsố Giátrị M/O Authorization Bearer M Content-Type application/json M clientMessageId This is unique message id generated by service consumer for 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 M/O Length walletID Mã ví String M 50 resourceId Mã liên kết String M 50 mobile Số điện thoại String M 20 - Output Output parameter Description Type M/O clientMessageId Client messageId String M errorCode SOA error code (error code description) String M errorDesc SOA error messages list Array String O data Kết xử lý Object O >mobile Số điện thoại String M >requestId Mã request String M ii) UnLink ewallter confirm URL https://[IPADDRESS]:[PORT]/ ms/ewallet/v1.0/unlink/confirm Method POST Description Xác nhận yêu cầu hủy liên kết ví - Header info Thamsố Giátrị M/O Authorization Bearer M Content-Type application/json M clientMessageId This is unique message id generated by service consumer for each request Using GUID is recommended M transactionId The transaction ID Transaction id and bill id is key which prevent duplicated transaction M - Input Parameter Description Type M/O requestId Request id String M otp Mã xác thực OTP String M Output parameter Description Type M/O clientMessageId Client messageId String M errorCode SOA error code (error code description) String M errorDesc SOA error messages list Array String O data Kết xử lý Object O >mobile Số điện thoại String M - Output 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 - 4192 The source not yet linked to wallet - 4630 Invalid request - 500 Unknown error - 502 Database error Service isn't supported APIGEE ErrorCode: - 203 'clientMessageId' header is mandatory - 203 Invalid Payload - 203 Params is missing - 402 Not found - 402 Requested resource not found - 240 Too many requests received in a short span of time - 240 Exceeded developer quota - 002 Gateway Timeout - 500 Internal Error Server - 500 Unknown error Please reach out to administrator THANH TỐN DỊCH VỤ a Mơ tả chung Khách hàng sau thực mở tài khoản điện tử phép toán tài khoản điện tử Hạn mức : Nạp tiền Thanh toán Rút tiền Level Level Level Level Level Level Số tiền giao dịch tối thiểu/1 GD 10,000 10,000 10,000 10,000 10,000 10,000 Số tiền giao dịch tối đa/1 GD 10,000,00 10,000,000 100,000,0 00 10,000,00 10,000,00 100,000,00 Số tiền giao dịch tối đa/1 ngày 50,000,00 50,000,000 1,000,000 ,000 50,000,00 50,000,00 1,000,000,0 00 Số tiền giao dịch tối đa/1 tháng unlimited unlimited unlimited 50,000,00 50,000,00 unlimited Số lần tối đa/ngày 20 20 20 20 20 20 b Luồng quy trình nghiệp vụ Level1 - Level Level 10,000 10,000 - 10,000,0 100,000,00 00 - 50,000,0 1,000,000, 00 000 - 50,000,0 00 unlimited 20 20 - QUY TRÌNH THANH TỐN TRÊN APP ĐỐI TÁC APP ĐỐI TÁC KHÁCH HÀNG HỆ THỐNG MB Start N QUY TRÌNH THANH TỐN TRÊN APP ĐỐI TÁC Khách hàng lựa chọn tính tốn hàng hóa Đối tác đẩy thơng tốn sang MB MB xác thực thông tin? Y 4.Khách hàng nhập mã OTP 3.1 MB gửi OTP cho KH N Chuyển thông tin OTP MB xác thực OTP? Y 7.MB Hạch toán 9.Hiển thị kết Nhận kết End c Luồng quy trình tích hợp STT Bước Nội dung Người thực Khách hàng lựa Khách hàng chọn tốn hàng hóa Diễn giải Khách hàng đăng nhập vào App ĐỐI TÁC lựa chọn tính năng: tốn hàng hóa + Hệ thống ĐỐI TÁC cho phép khách hàng nhập thông tin toán (Bao gồm : Số tiền – Nội dung toán) + TransType: Loại giao dịch giao dịch tốn hàng hóa + MerchantID: mã merchant tương ứng + Mã hóa đơn Lưu ý:Hệ thống ĐỐI TÁC cho phép khách hàng chuyển liên kết gắn nguồn tài khoản; Bước Chuyển thông ĐỐI TÁC tin tốn Hệ thống ĐỐI TÁC kiểm tra thơng tin khách hàng trước gửi sang MB - Kiểm tra số tiền chuyển: + Nếu số tiền không định dạng, hiển thị thông báo “Số tiền không định dạng, vui lòng nhập lại số tiền” + Nếu số tiền nhỏ số tiền tối thiểu giao dịch, hiển thị thông báo lỗi “Số tiền giao dịch nhỏ số tiền tối thiểu/1 giao dịch, vui lòng nhập lại số tiền ”; + Nếu số tiền lớn số tiền giao dịch tối đa giao dịch, hiển thị thông báo lỗi “Số tiền giao dịch lớn số tiền tối đa/1 giao dịch, vui lòng nhập lại số tiền” + Nếu thông tin số tiền hợp lệ, chuyển sang bước tiếp theo; - Kiểm tra thông tin nội dung: + Nếu trường nội dung để trống, hiển thị thông báo lỗi “Trường nội dung để trống, vui lòng nhập lại trường nội dung”; + Nếu trường nội dung hợp lệ, chuyển sang bước - Thông tin ĐỐI TÁC đẩy sang MB bao gồm trường thông tin sau: + RequestID cho ghi + WALLET ID (Gắn vớ`i Khách hàng) + Họ tên người chuyển tiền + Mã hóa đơn + Mã merchant + Số tài khoản người nhận: 050-11-66868-88-8 + Tên chủ tài khoản nhận tiền: WILAD SOLUTIONS + Số tiền toán + Nội dung toán  Chuyển sang bước Bước MB xác thực Hệ thống MB Hệ thống MB tiếp nhận thơng tin tốn kiểm tra thơng tin tốn: + Nếu thơng tin WALLET ID người chuyển không tồn tại: Sẽ trả thông báo lỗi “ Khách hàng chưa liên kết, vui lòng thực liên kết”; + Nếu WALLET ID tên người chuyển không theo lưu hệ thống: MB trả thông báo lỗi “Thông tin khách hàng không đúng” + Nếu số tài khoản người nhận không tồn danh sách tài khoản nhận ĐỐI TÁC lưu hệ thống: MB trả thông báo lỗi dừng lại + Nếu số tài khoản tên chủ tài khoản không đúng: MB trả thông báo lỗi dừng lại + Nếu thông tin hợp lệ, hệ thống MB gửi mã OTP cho khách hàng (Qua số điện thoại KH đăng ký với NH) trả thông báo tới ĐỐI TÁC để ĐỐI TÁC chuyển đến hình nhập mã OTP; Cú pháp SMS gửi OTP cho KH: OTP Quy khach la: OTPvalue Ma xac thuc giao dich tren ĐỐI TÁC co hieu luc vong phut QK TUYET DOI khong cung cap OTP cho nguoi khac tranh bi lua dao! Bước Nhập mã xác Khách hàng thực Khách hàng nhập mã xác thực OTP Bước Chuyển tin OTP Hệ thống ĐỐI TÁC Verify thông tin trước gửi sang MB để xác thực thông ĐỐI TÁC + Nếu khách hàng không nhập mã OTP, hệ thống hiển thị thông báo lỗi “Mã xác thực để trống, vui lòng nhập lại mã xác thực” + Nếu mã xác thực không định dạng (Khác số), hệ thống hiển thị thông báo lỗi “Mã xác thực không định dạng, vui lòng nhập lại mã xác thực” + Nếu mã xác thực hợp lệ => Chuyển sang NH để xác thực  Chuyển sang bước Bước Xác thực OTP Hệ thống MB Hệ thống MB xác thực thông tin + Nếu mã xác thực không hợp lệ, hiển thị thơng báo lỗi “Mã xác thực khơng xác, vui lòng thực lại giao dịch” + Nếu mã xác thực hết thời hạn hiệu lực, hiển thị thông báo lỗi “Mã xác thực hết hiệu lực, vui lòng thực lại giao dịch” + Nếu mã xác thực hợp lệ, Chuyển sang bước MB hạch toán  Chuyển sang bước Bước MB Hạch toán Hệ thống MB MB kiểm tra thông tin - Kiểm tra thông tin số tiền giao dịch + Nếu số tiền giao dịch > Số dư TK, hiển thị thông báo lỗi “Số dư tài khoản không đủ để thực giao dịch, vui lòng kiểm tra lại TK” + Nếu số tiền giao dịch > Tổng số tiền giao dịch ngày tài khoản, hệ thống hiển thị thông báo lỗi “Tổng số tiền giao dịch lớn tổng số tiền giao dịch ngày, vui lòng kiểm tra lại”; - Hệ thống MB thực hạch toán theo luồng hạch toán sau: Ghi nợ TK KH chuyển : Số tiền giao dịch + Phí (Nếu có) Ghi có TK đến merchant: Số tiền giao dịch Ghi có TK Phí (Nếu có): Số tiền phí => MB hạch tốn xong Chuyển sang bước Bước Nhận kết ĐỐI TÁC ĐỐI TÁC nhận kết trả từ MB hiển thị kết giao dịch cho khách hàng; + Thông báo lỗi, hiển thị thông báo lỗi chi tiết cho khách hàng + Thông báo giao dịch thành công tới khách hàng ... Nhận kết hủy MB liên kết - Napas thực hủy liên kết trả kết MB MB nhận kết trả từ Napas: + Nếu hủy liên kết Token thành công: MB thực hủy liên kết trả kết cho khách hàng + Nếu hủy liên kết Token... TK ĐIỆN TỬ MB QUA NAPAS GIAO DỊCH HỦY LIÊN KẾT VÀO TK ĐIỆN TỬ MB QUA NAPAS ĐỐI TÁC KHÁCH HÀNG MB NAPAS Start Gửi yêu cầu Hủy Liên kết TKĐT Lựa chọn tính Hủy Liên kết TKĐT Hiển thị KQ Hủy liên kết. .. trình nghiệp vụ i) Lưu đồ LIÊN KẾT THẺ NGOÀI MB VỚI TÀI KHOẢN ĐIỆN TỬ QUA NAPAS LIÊN KẾT THẺ NGOÀI MB VỚI TÀI KHOẢN ĐIỆN TỬ QUA NAPAS KHÁCH HÀNG ĐỐI TÁC MB NAPAS TCPH Gửi yêu cầu Liên kết TKĐT