Alepay Microform

Lưu ý: Nội dung các tham số trong các phương thức của Microform có thể sẽ có điều chỉnh cho phù hợp với yêu cầu thực tế. Nội dung cập nhật (nếu có) sẽ được bổ sung vào các version sau.

Alepay Microform là thư viện javascript cho phép Merchant nhúng vào trang checkout để thực hiện thanh toán cho các giao dịch chưa có token thẻ

- Link thư viện Live: https://alepay-v3.nganluong.vn/pay/microform/web/js/1.0/alepay-microform.js

- Link thư viện Sandbox: https://alepay-v3-sandbox.nganluong.vn/pay/microform/web/js/1.0/alepay-microform.js

a. Cách tích hợp

Tại trang checkout, tạo một <div> container để chứa Iframe nhập thông tin thẻ khi gọi Microform từ Alepay. Cách tích hợp được mô tả như sau:

b. Phương thức khởi tạo

- Khai báo: (static) init(options, callback)

Tên trường

Định dạng

Bắt buộc

Mặc định

Mô tả

Options

Object

T

  

Chứa các thuộc tính cho thanh toán giao dịch

callback

callback

T

  

Callback function: nhận error và microformInstance khi init thành công

• error: object

• microformInstance: instance của class Microform dùng để gọi các method tạo token, thanh toán token, ...

Lưu ý: Nếu tham số renderIframe trong Options là False thì microformInstance của microform sẽ trả về thêm 2 tham số iframeSrc và iframeId cho phép tùy chỉnh microform

 

Tham số Options là một Object chứa các tham số đầu vào phục vụ cho thanh toán giao dịch, các tham số được mô tả như sau:

Tên trường

Định dạng

Bắt buộc

Mặc định

Mô tả
container String T   CSS Selector của container sẽ chứa iframe
targetOrigin String T   Protocol, URL, port number (nếu có) của trang sẽ dùng Microform
cardRequestToken String T   Giá trị lấy từ Api “Tạo yêu cầu liên kết thẻ” 
viewType String T  

“Web”: hiển thị dạng web

“App”: hiển thị dạng app
renderIframe String T False

False: trả vể URL microform để Merchant tự nhúng vào trang checkout

True: Alepay tự render microform vào trang checkout của Merchant

 

c. Khởi tạo Token

- Khai báo: createToken(tokenType, callback, paymentMethod)

- Tham số:

Tên trường

Định dạng

Bắt buộc

Mặc định

Mô tả

tokenType

Number

T

  

1: token dùng 1 lần; 

2: token dùng nhiều lần
callback callback    

callback function: nhận error và response

  • error: Object chứa message (mô tả lỗi), nếu không có lỗi error = null

  • response: là Object chứa cardNumber(số thẻ đã được mask), bankCode, bankName, token, paymentMethod, iframeSrc
paymentMethod String F  

Loại thẻ cần nhập: VISA / MASTERCARD / JCB