1. Giới thiệu MoMo:
- MoMo Payment Platform API là giải pháp thanh toán cho các đơn vị kinh doanh, cho phép khách hàng sử dụng tài khoản Ví MoMo để thanh toán các dịch vụ trên nhiều nền tảng khác nhau: Desktop Website, Mobile Website, Mobile Application, POS, Pay In Bill, Web In App MoMo.
2. Các phương thức thanh toán của:
- Cổng thanh toán MoMo (All In One): Áp dụng cho đối tác có thanh toán trên nền tảng Website, Mobile, Smart TV, ...
- Thanh toán App-In-App: Áp dụng cho đối tác có ứng dụng di động (Android/iOS) muốn mở trực tiếp ứng dụng MoMo để thanh toán.
- Thanh toán POS: Áp dụng cho đối tác có hệ thống bán hàng bằng máy POSS. Thu ngân dùng máy scan đẻ quét "MÃ THANH TOÁN" trên app MoMo để thanh toán.
- Thanh toán QR Code: Đối tác tạo QR code để theo định dạng MoMo cung cấp, khách hàng chỉ cần dùng app MoMo để quét mã và thanh toán.
Trong bài viết này mình sẽ sử dụng cổng thanh toán MoMo All In One.
3. Quy trình tích hợp:
-
Thực hiện đăng ký business account tại https://business.momo.vn/.
-
Sau khi đăng ký account, môi trường mặc định của account là môi trường Test.
-
Bạn cần thực hiện đăng ký đầy đủ thông tin để đưa account lên môi trường Production.
-
Đối với từng loại môi trường, MoMo API cung cấp cho bạn các thông tin sau để cấu hình và sử dụng MoMo API
- Partner Code: Thông tin để định danh tài khoản doanh nghiệp.
- Access Key: Cấp quyền truy cập vào hệ thống MoMo.
- Secret Key: Dùng để tạo chữ ký điện tử signature.
- Public Key: Sử dụng để tạo mã hóa dữ liệu bằng thuật toán RSA.
-
Khi gọi Sử dụng MoMo API ta sẽ gọi tới 2 end point sau tùy theo môi trường:
- Môi trường test: https://test-payment.momo.vn
- Môi trường production: https://payment.momo.vn
4. Security:
- MoMo sử dụng chữ ký điện tử và mã hóa dữ liệu để xác thực dữ liệu đầu vào và ra trên mỗi yêu cấu HTTP Request và HTTP Response.
- Tham khảo source code tại GitHub của MoMo.
a. Chữ ký điện tử:
signaturelà chuỗi ký tự được tạo ra từ một thuật toán cho trước, sử dụng để kiểm tra tính đúng đắn của dữ liệu trên đường truyền giữa hai hệ thống.- Ví dụ
digest = OpenSSL::Digest.new('sha256') signature = OpenSSL::HMAC.hexdigest(digest, serectkey, rawSignature) - MoMo sử dụng thuật toán SHA256 để tạo singature cho data của mỗi request.
- serectkey là
SECRET_KEYcủa business account đã đăng ký với MoMo. - rawSignature là chuỗi được tạo từ data của order cần được thanh toán bởi MoMo theo cặp
key=valuevà được nối lại với nahu bằng&, ví dụ:key1=value1&key2=value2.
b. Mã hóa RSA:
- Mã hóa RSA là thuật toán mã hóa công khai để bảo vệ thông tin trên đường truyền.
- Đối tác sử dựng
PUBLIC_KEYcủa business account đã đăng ký với MoM để mã hóa data của order cần được thanh toán bởi MoMo. - MoMo sử dụng
PRIVATE_KEYứng vớiPUBLIC_KEYđể giải mã và kiểm tra dữ liệu đã được mã hóa.
5. Cổng thanh toán MoMo (All In One):
a. Giới thiệu:
- MoMo AIP Payment là giải pháp thanh toán của MoMo áp dụng trên nhiều nền tảng khác nhau chỉ trong 1 API duy nhất.
- Đối với môi trường TEST bạn có thể download app MoMo TEST và thực hiện thanh toán hoặc sử dụng account test do MoMo cung cấp sẵn.
Thành công Hạn mức 20.000.000 Hạn mức 5.000.000 Không thành công 0917003003 0919100100 0918002000 0916005000 0917030000 0919100010 0918002020 0916005050 0917030003 0919100001 0918002200 0916005500 0917030030 0919010100 - - 0917030300 0919010010 - - 0917300300 0919100101 - - - Mật khẩu:
000000. - Mã xác thực:
000000. - Thông tin chi tiết xem tại Thông tin Testing của MoMo.
b. Sơ đồ xử lý:
-
Thực hiện thanh toán với MoMo thông qua cổng thanh toán AIO trên web theo các bước sau:
- User click buttton thanh toán trên màn hình Web.
- Server gửi request lên MoMo.
- Momo trả HTTP Response về Server.
- Nếu request chứa data hợp lệ thì MoMo trả HTTP Response có errorCode là 0 là payUrl.
- Server thực hiện redirect đến payUrl của MoMo để user thực hiện thanh toán.
- Kết quả thanh toán được MoMo gửi đến returnUrrl và notifyUrl của server.
- Server nhận kết quả thanh toán và update order.
- Nếu request của bước 2 chứa data không hợp lệ thì tại bước 3 MoMo trả HTTP Response có errorCode khác 0 và message chứa nội dung lỗi.
-
Để thực hiện thanh toán với cổng thanh toán AIO, gửi request lên end point của MoMo.
POST /gw_payment/transactionProcessor
c. Data request lên MoMo:
- Các data cần gửi lên MoMo để thực hiện thanh toán thông qua cổng thanh toán AIO bao gồm.
Attribute Description partnerCode PARTNER_CODE lấy từ business account đăng ký với MoMo accessKey ACCESS_KEY lấy từ business account đăng ký với MoMo requestId Định danh mỗi yêu cầu amount Số tiền cần thanh toán orderId Mã đơn hàng cần thanh toán (cần đảm bảo tính duy nhất) returnUrl Trang web mà MoMo sẽ redirect về sau khi user thực hiện thanh toán xong
cần cung cấp cả domain và path của Url (ví dụ: https://example.com/orders/1)notifyUrl Trang web mà MoMo sẽ gửi data về thông qua IPN sau khi user thực hiện thanh toán xong
cần cung cấp cả domain và path của Url (ví dụ: https://example.com/orders/1)requestType captureMoMoWallet signature Chữ ký điện tử để kiểm tra thông tin extraData Thông tin bổ sung cho order theo định dạng <key>=<value>;<key>=<value>
mặc định là "" - Tham khảo tài liệu của MoMo để biết thêm chi tiết.
- Tham khảo Momo::ApplicationSerrvice để xem ví dụ với Rails.
- Mình sử dụng Momo::RequestSignatureService để tạo signature.
d. returnUrl và notifyUrl:
- Là 2 url của Server mà MoMo sẽ gửi HTTP Response chứa kết quả thông tin thanh toán.
- Với returnUrl MoMo sẽ gửi qua method GET, redirect từ MoMo về returnUrl sau khi user thực hiện thanh toán xong.
- Với notifyUrl MoMo sẽ gửi qua method POST, MoMo thực hiện IPN để gửi data về notifyUrl sau khi user thực hiện thanh toán xong.
- Với returnUrl và notifyUrl thực hiện kiểm tra data nhận về từ MoMo có khớp với data gửi lên MoMo hay không và update orders thông qua Momo::ConfirmOrrderService và Momo::UpdateOrrderService.
- Tránh trường hợp user tự gõ url để update order mà không thông qua thanh toán MoMo.
- Trong code mẫu returnUrl ứng với
MoMo::PaymentsController#showvà notifyUrl ứng vớiMoMo::PaymentsController#update MoMo::PaymentsController#createthực hiện gọi MoMo AIO API thông qua Momo::SendRequestService và redirect về payUrl để thực hiện thanh toán trên MoMo.- Ta cần sử dụng cả returnUrl và notifyUrl để tránh trường hợp MoMo không redirect về returnUrl (do timeout, user tắt trình duyệt) thì server vẫn nhận được data thông qua notifyUrl.
e. Data mà MoMo trả về:
- Các data cần gửi lên MoMo để thực hiện thanh toán thông qua cổng thanh toán AIO bao gồm.
Attribute Description partnerCode PARTNER_CODE lấy từ business account đăng ký với MoMo accessKey ACCESS_KEY lấy từ business account đăng ký với MoMo requestId Định danh mỗi yêu cầu amount Số tiền cần thanh toán orderId Mã đơn hàng cần thanh toán (cần đảm bảo tính duy nhất) returnUrl Trang web mà MoMo sẽ redirect về sau khi user thực hiện thanh toán xong
cần cung cấp cả domain và path của Url (ví dụ: https://example.com/orders/1)notifyUrl Trang web mà MoMo sẽ gửi data về thông qua IPN sau khi user thực hiện thanh toán xong
cần cung cấp cả domain và path của Url (ví dụ: https://example.com/orders/1)requestType captureMoMoWallet signature Chữ ký điện tử để kiểm tra thông tin extraData Thông tin bổ sung cho order theo định dạng <key>=<value>;<key>=<value>
mặc định là ""
6. Màn hình demo:
