WIXLIB

CodestringKhôngMã Merchant mà JetPayPayment cấp cho đơn vị chấpnhận thanh toánReturnUrlstringKhôngUrl hệ thống của Merchant,dùng để JetPay redirect vềbáo kết quản giao dịch thànhcôngCancelUrlstringKhôngUrl hệ thống của Merchant,dùng để JetPay redirect vềbáo kết quản giao dịch thấtbại(KH hủy giao dịch hoặccó lỗi hệ thống)Response success – HttpCode 200Tham sốKiểu dữliệuCó thểtrốngVí dụMô a3aId của giao dịchtrên hệ inland?transactionId 6d6d12cee918-4d7c-a76b-99fdfffdfbceUrlCheckout đểđơn vị redirectsang JetPayPayment pageviettelpay://action/command AppInvoke&merchant code DLTS14&order id 1540350100433&billcode BILL 2018-10-Deeplinkchuyển hướngkhách hàng tớiApp thanh toán(Chỉ dùng vớiPaymentType: 7ViettelMoney)

Response fail – HttpCode # 200Tham sốKiểu dữliệuCó thểtrốngVí dụCodeStringKhôngE1002Mã lỗi trả vềMessageStringKhôngOrderId is duplicateMô tả lỗiDetailsStringKhôngThe following errors weredetected during validation.Mô tả lỗiDataStringObject{}Mô tả lỗiValidationErrorsStringList Object []Mô tả lỗiMã lỗiMã HTTPMã lỗiMô tả lỗi400E1000MerchantCode is invalid400E1001OrderId is duplicate400E1005Amount is invalid400E1006Tokenization is invalid500E3000Internal server errorMô tả

3. Chuyển trang thanh toán (Luồng thanh toán thẻ)Website/App của merchant nhận diện khách hàng có cài App tương ứng với phương thức thanhtoán hay không. Nếu có, chuyển hướng khách hàng tới App thông qua deeplink.Nếu không, khách hàng sẽ được chuyển (redirect) từ trang thanh toán của merchant sang trangthanh toán của JetPay dựa vào field urlCheckout mà bạn đã tạo yêu cầu thanh toán thành công ởmục 2 và sẽ đính kèm tham số vào URL có định dạng như sau:urlCheckout&signature signatureLưu ý: Trong trường hợp phương thức thanh toán là Viettel Money thì không cần thêm tham sốsignature vào URL Signature là một chuỗi kí tự được tạo từ một thuật toán cho trước, sử dụng để kiểm tratính đúng đắn của dữ liệu.Cách tạo chữ kí:Thuật toán JetPay đang sử dụng để tạo chữ kí là SHA256 để tạo signature. Dữ liệu đầu vào làmột chuỗi được kết hợp từ mã giao dịch và key checksum (Jetpay cung cấp cho merchant):inputDataSHA256 transactionId keyChecksum;signature SHA256(inputDataSHA256);Ví dụ:var transactionId “909e23c4-4797-4e53-92d3-e04d035c6afb”var key “7625674c-22cf-4a5f-baf5-da3df6e7e1e0”var data transactionId key;var signature thods/inland?transactionId 943403cd4807-40e1-a0f987aef051def7&signature 38F321E27AF9114. Nhận kết quả giao dịch (Luồng thanh toán thẻ)Merchant cần phải tạo một API ở phía backend để lắng nghe kết quả từ phía JetPay và cập nhậtdữ liệu.Sau khi khách hàng thanh toán trên cổng thanh toán của JetPay, JetPay sẽ gửi thông báo kết quảngay lập tức tới URL của API để cập nhật dữ liệu.

URL của API sẽ được cấu hình trên trang của MerchantWebAdmin.Xây dựng API.Url: Merchant cung cấp domain cho JetPayMethod: POSTRequestTham sốKiểu dữ liệuCó thểtrốngVí dụMô tảOrderIdstringKhông“OD123456”Mã đơn hàng trên hệthống 035c6afb”Mã giao dịch của JetpayAmountstringKhông11000Không3StatusintSố tiền thanh toánTrạng thái giao dịch:2: Giao dịch thất bại3: Giao dịch thành công4: Hết hạn thanh toán5: Hủy giao dịchTokenizationstringCóTokenization trả về vớitrường hợp thanh toánkèm lưu thông tin IntKhông1Phương thức thanh toánThông tin mã ngân 56(CheckThông tin số thẻ dạngmaskCheckSum bảo mật dữ

AdditionalInfoDictionary string, string CóSumKey OrderId Amount Status)liệu(dùng thuật toán bămSHA256)AdditionalInfo[“BankCode”]Các dữ liệu phát sinh vớinghiệp vụ của từng dự ánLưu ý: URL không phải là một dạng của localhost. IP của JetPay được phép truy cập tới máy chủ của bạn.Chứng chỉ HTTPS hợp lệ.5. Khởi tạo giao dịch (Luồng thanh toán QRCode, ví điện tử, mobile money)Url: Domain QRCode/qrcodesMethod: POSTHeaderTham sốAuthorizationRequestKiểu dữ liệuCó thể trốngstringKhôngVí dụMô tả“Bearer” tokenToken trả về ở api lấytoken

Tham sốKiểu dữliệuCó thểtrốngĐộ dàiMô tảCountryCodestringKhông2Mã vùng, mặc định là VNMerchantCodestringKhôngMax(20)Mã merchant do Jetpay cungcấpPayTypestringKhôngMax(4)Kiểu QRCode-01: QRCode cổngthanh toán02: QRCode sảnphẩm03: QRCode điểmbán04: QRCode hóa đơn05: Thanh toánmomo06: Thanh toánViettelMoney07: Thanh toánZaloPayProductIdstringCóMax(20)Mã sản phẩm (Để trống nếutạo QRCode có type 01,03,04)TxnIdstringCóMax(15)Mã đơn hàng, mã giao dịch(Dùng cho payType 01, 05,06,07)BắtbuộcpayType 05,06,07BillNumberstringKhôngMax(15)Số hóaterminalđơnAmountstringKhôngMax(13)Số tiền thanh toánvới payType 05vớiQRCode

Nhỏ Nhất: 10.000 VNDTối đa: 20.000.000 VNDCcystringKhôngMax(3)Mã tiền tệ. Mặc định là 704ExpDatestringKhôngMax(14)Thời gian hết hạn thanh toán,định dạng: yyMMddHHmmDescstringCóMax(19)Mô tảBắtbuộcpayType 05,07vớiTipAndFeestringCóMax(20)Tiền tip and fee, giá trị mặcđịnh để emptyConsumerIdstringCóMax(20)Mã khách hàng, dành choQR type 04PurposestringCóMax(19)Mã dịch vụ billing cho QRtype 04RedirectUrlstringCóPayType 05,07 (bắt buộc):URL này được sử dụng đểchuyển trang (redirect) từMoMo,ZaloPay về trangmua hàng của đối tác sau khikháchhàngthanhtoán(apptoapp hoặc QRCodecủa CTT).PayType 06:URLđểchuyển trang sau khi kháchhàng thanh toán thành côngCancelUrlstringResponse success – HttpCode 200CóPayType 06:URLđểchuyển trang sau khi kháchhàng hủy thanh toán hoặcthanh toán không thành công

Tham sốKiểu dữ óVí dụMô tảDữ liệu để pay?t TU9NT1NKSTEyMDE5MDgyM3wxNjEzNTMyMDURL để chuyểnsang trang thanhtoán của MoMohoặcViettelMoney,ZaloPaypayType 05,06,07DeeplinkstringCóMomo:”momo://action payWithAppToken&amount 150000&fee 0&requestType payment”ZaloPay: “2553 20090400000112548Y3z18”Format(app id zp trans token) sửdựng để tích hợp SDKTải SDK tích hợptại o.htmlURL để mở ng phải cài đặtứngdụngMoMo,ZaloPaytrước) và xác nhậnthanh toán.PayType 05,07

DeeplinkMiniAppCóURL mở màn hìnhxác nhận thanh toáncủaứngdụngMoMo. Áp dụngkhi đối tác sử dụngmini app nhúng vàotrong ứng dụngMoMo.payType 05Response fail – HttpCode # 200Tham sốKiểu dữliệuCó thểtrốngVí dụCodeStringKhôngE1000Mã lỗi trả vềMessageStringKhôngData input is not in formatMô tả lỗiDetailsStringKhôngThe following errors weredetected during validation.Chi tiết lỗiDataObjectCóDataValidationErrorsList Object CóChi tiết lỗivalidationMã lỗiMã HTTPMã lỗiMô tả lỗi400E1000MerchantCode is invalid400E1001ConsumerId is null or emptyMô tả

400E1002Data input is not in format400E1004Purpose is null or empty400E1007TxnId is duplicate400E1008ClientId inValid400E1014Fee amount inValid400E1015Transaction amount inValid400E1016Transaction amount is less than the minimum limit400E1017Transaction amount is more than the maximumlimit400E1018Transaction amount exceeds daily transaction limit400E1019Transaction amount exceeds monthly transactionlimit400E1020RedirectUrl Must Not Be Blank400E1021Description Must Not Be Blank400E1022TxnId Must Not Be Blank401500Token is invalidE3000Internal server error

6. Nhận kết quả giao dịch (Luồng thanh toán QRCode, ví điện tử, mobile money)Merchant cần phải tạo một API ở phía backend để lắng nghe kết quả từ phía JetPay và cập nhậtdữ liệu.Sau khi khách hàng thanh toán trên cổng thanh toán của JetPay, JetPay sẽ gửi thông báo kết quảngay lập tức tới URL của API để cập nhật dữ liệu.Url: Merchant cung cấp domain cho JetPay.Method: POSTRequestTham sốCodeKiểu dữliệuVí dụstringMô tảMã lỗi phần trừ tiền khách hàng“00”: Thành côngMessagestringMô tả mã lỗi truyền vàoTxnIdstringMã đơn hàngQRTracestringSố trace giao dịchBankCodestringMobilestringSố điện thoạiAccountNostringSố tài khoảnAmountstringSố tiền thanh toánPayDatestringThời gian hết hạn thanh toán, định dạng:yyMMddHHmmMerchantCodestringMã merchant do jetpay cung cấp“MOMO”Mã ngân hàng thanh toán

NamestringTên người nhận hàng. Tối đa không quá255 ký tựPhonestringSố điện thoại nhận hàngProvinceIdstringId của tỉnh nhận hàngDistrictIdstringId của quận, huyện nhận hàngAddressstringĐịa chỉ nhận hàngEmailstringĐịa chỉ emailAddDataList QRCodeItemPayment Với QRCodeItemPpayment là object baogồm các trường sau:stringLà mã hóa MD5 của chuỗi sau:Checksum-string: ProductId //Mã sản phẩmstring: Amount //Đơn giánstring: TipAndFee //Tiền tip, phístring: Ccy // Mã tiền tệstring: Qty: //Số lượngstring: Note //Ghi chúcode " " txnId " " qrTrace " " bankCode " " mobile " " accountNo " " amount " " payDate " " merchantCode " " ChecksumKeyVới ChecksumKey do JetPay cung cấpcho MerchantResponseTham sốKiểu dữliệuVí dụMô tả

CodestringMã lỗi trả về. Mô tả chi tiết bảng bêndướiMessagestringMô tả mã lỗi truyền vàoDataString(json)Chi tiết lỗiMô tả lỗiMã lỗi trả vềMã HTTPMãlỗiKiểu dữliệu20001StringThiếu hàng trong đơn hàngThông tin message sẽ hiển thị dạng ListJson các sản phẩmthiếu Products với nội dung cụ thể baogồm:Data{- String: productid;// Mã sản phẩm- String: qty;// Số lượng còn trong kho}20002StringHết toàn bộ hàng trong đơn hàngThông tin message sẽ hiển thị dạng String:“Kho hàng đã hết sản phẩm”20003StringĐơn hàng đã được thanh toánThông tin message sẽ hiển thị dạng String:“Đơn hàng đã được thanh toán”.Data{- String: txnId; // Mã đơn hàng}

20004StringLỗi tạo đơn hàngThông tin message sẽ hiển thị dạng Stringmô tả mã lỗi exception.20005StringThông tin message sẽ hiển thị dạng String:“đơn hàng đang được xử lí”Data{- String: txnId; // Mã đơn hàng}20006StringThông tin message sẽ hiển thị dạng String:“sai thông tin xác thực”20007StringThông tin message sẽ hiển thị dạng String:“số tiền không chính xác”Data{- String: amount; // Số tiền chính xác củađơn hàng}20008StringGiao dịch timout20009StringQR hết hạn thanh toán20010StringIP không được truy cập20011StringGiao dịch thanh toán thất bại do tài khoản người dùngkhông đủ tiền20012StringThẻ được dùng để thanh toán hiện không còn khả dụng20013StringGiao dịch bị đã bị hủy

20014StringGiao dịch thất bại do số tiền thanh toán vượt quá hạn mứcthanhtoán của người dùng.20015StringGiao dịch thất bại do người dùng đã từ chối xác nhậnthanh toán.20016StringGiao dịch bị từ chối vì tài khoản người dùng đang ở trạngtháitạm khóa.20017StringGiao dịch bị hạn chế theo thể lệ chương trình khuyến mãi20000StringThông tin message sẽ hiển thị dạng String:“đặt hàng thànhcông”Data{- String: txnId; // Mã đơn hàng}7. Khởi tạo giao dịch (Luồng thanh toán Chuyển khoản)Sử dụng để tạo các yêu cầu thanh toán bằng hình thức chuyển khoản đáp ứng 2 kiểu thanh toán: Thanh toán bằng nhập số tài khoản Thanh toán bẳng quét QRCodeUrl: Domain Transfer/transfermoneyMethod: POSTHeaderTham sốAuthorizationKiểu dữ liệuCó thể trốngstringKhôngVí dụMô tả“Bearer” tokenToken trả về ở api lấy

tokenRequestTham sốKiểu dữ liệuCó thể trốngVí dụMô tảMerchantCodeString(20)Không0000102Mã ĐVCNTT JetPay cungcấpOrderIdString(15)Cóabc123Danh sách mã đợt thu ngăncách nhau bởi dấu ; (nếuphụ huynh gạch nợ hết thì sẽđể là null)CustomerCodeString(8)CóabcxyzMã sisapAmountLongKhông100000Số tiền hóa đơnString(255)CóThanh toán hóađơnMô tả đơn hàngDescriptionFeeLongCó. Mặc định se success – HttpCode 200BIDV- Phí chuyển khoản virtualaccount áp dụng cho kháchhàng.- Nếu tính phí merchant thìFee 0Mã ngân hàngPhương thức thanh toán:9: Chuyển khoản

Tham sốKiểu dữ ingCó thể trốngKhôngKhôngKhôngVí dụMô tảJP000001abcxyzTài khoản ảo được tạo bởiJetPayBIDVNgân hàng thụ hưởng virtualaccountNgân hàngThương mại cổphần Đầu tư vàPhát triển ViệtNamTên ngân hàng thụ hưởngvirtual accountKhôngJETPAY THCSGiảng VõTên tài khoản thụ hưởngvirtual account100000Số tiền thanh ringKhôngMerchantCodeStringKhôngData để gen QrCode0000102Mã MerchantResponse success – HttpCode ! 200Tham sốKiểu dữ liệuCó thểtrốngVí dụMô tảcodeStringKhôngE1000Mã lỗi trả vềmessageStringKhôngMerchantCode is invalidMô tả lỗidetailsStringKhôngThe following errors weredetected during validation.Chi tiết lỗi

dataObjectCóDatavalidationErrorsList Object CóMô tả lỗivalidationMã lỗiMã HTTPMã lỗiMô tả lỗi400E1000MerchantCode is invalid400E1001OrderId is invalid400E1002OrderId is duplicate400E1003Fee is invalid401500UnauthorizedE3000Internal server error8. Nhận kết quả giao dịch (Luồng thanh toán Chuyển khoản)Merchant cần phải tạo một API ở phía backend để lắng nghe kết quả từ phía JetPay và cập nhậtdữ liệu.Sau khi khách hàng chuyển khoản thành công, JetPay sẽ gửi thông báo kết quả ngay lậptức tới URL của API để cập nhật dữ liệu.Url: Merchant cung cấp domain cho JetPayMethod: POST

RequestTham sốKiểu dữliệuVí dụMô tảTransactionCodestringMã hóa đơn của Jetpay(duy nhất trên hệthống của Jetpay)ConsumerIdstringMã khách hàngTxnIdstringMã đơn hàngQRTracestringSố trace giao dịchBankCodestringAccountNostringSố tài khoảnAmountstringSố tiền thanh toánMerchantCodestringMã merchant do jetpay cung cấpChecksumstringLà mã hóa MD5 của chuỗi sau:“BIDV”Mã ngân hàng thanh toánqrTrace " " bankCode " " accountNo " " amount " " merchantCode " " ChecksumKeyVới ChecksumKey do JetPay cung cấpcho MerchantResponseTham sốCodeKiểu dữliệustringVí dụMô tảMã lỗi trả về. Mô tả chi tiết bảng bêndưới

MessagestringMô tả mã lỗi truyền vàoDataString(json)Chi tiết lỗiMã HTTPMã lỗiKiểu dữliệuMô tả lỗi20001StringThiếu hàng trong đơn hàngThông tin message sẽ hiểnthị dạng List Json các sảnphẩmthiếu Products với nộidung cụ thể bao gồm:Data{- String: productid;// Mãsản phẩm- String: qty;// Số lượngcòn trong kho}20002StringHết toàn bộ hàng trong đơnhàngThông tin message sẽ hiểnthị dạng String: “Kho hàngđã hết sản phẩm”20003StringĐơn hàng đã được thanhtoánThông tin message sẽ hiểnthị dạng String: “Đơn hàngđã được thanh toán”.

Data{- String: txnId; // Mã đơnhàng}20000StringThành côngThông tin message sẽ hiểnthị dạng String: “đặt hàngthànhcông”Data{- String: txnId; // Mã đơnhàng}200E3000StringLỗi hệ thốngVII. Lưu ý khi sử dụng webview nhúng Cổng thanh toán JETPAY trên app MobileKhi sử dụng webview nhúng Cổng thanh toán JETPAY trên app Mobile sẽ cần bổ sung:- Cho phép Javascript hoạt động

- Thêm event xử lý download ảnh QRCode1. AndroidVí dụ code bằng Kotlin// Cho phép Javascript hoạt độngwebview.settings.javaScriptEnabled truewebview.setDownloadListener { url,contentTypeLength - // Url ảnh QRCode sẽ tDisposition,Ví dụ code bằng Java// Cho phép Javascript hoạt động trong webviewWebSettings webSettings nabled(true);// bắt sự kiện download ảnh QRCodemWebView.setDownloadListener(new DownloadListener() {public void onDownloadStart(String url, String userAgent,String contentDisposition, String mimetype,long contentLength) {downloadImageFromUrl(url);}});2. IOSVí dụ code bằng Swiftimport Foundationprotocol WebDownloadable: WKDownloadDelegate {func downloadDidFinish(fileResultPath: URL)func downloadDidFail(error: Error, resumeData: Data?)}class WebContentDownloader: NSObject {private var filePathDestination: URL?weak var downloadDelegate: WebDownloadable?mimeType,

func generateTempFile(with suggestedFileName: String?) - URL {let temporaryDirectoryFolder URL(fileURLWithPath: NSTemporaryDirectory(),isDirectory: true)return ggestedFileName ?ProcessIn

9 7k{qj wlq f x kuqk-(73 fxqj f s fkr 9&177 kdl p{l wu m áqj ÿ Ç wtfk k çs 7(67 6 ñ g éqj wurqj txi wuuqk wtfk k çs [k\ g õqj wtqk q qj nl Çp wk ñ ghexj 352'8&7,21 6 ñ g éqj ÿ Ç wul Çq nkdl fkr nkifk kjqj 7k{qj wlq f x kuqk 677 7kdp v Õ *li wu Ï p{l wu m áqj 7(67 *li wu Ï p{l wu m áqj 352'8&7,21