Tấn Phát Digital

Tích hợp MoMo vào website: quy trình, API và code mẫu

24 tháng 2, 2026
6.170
Technology
thanh toán online
MoMo
API
Tích hợp MoMo vào website: quy trình, API và code mẫu - Tấn Phát Digital

Sự dịch chuyển mạnh mẽ từ nền kinh tế tiền mặt sang nền kinh tế số tại Việt Nam đã thiết lập một bối cảnh mới, nơi các ví điện tử không còn đơn thuần là công cụ thanh toán mà trở thành một siêu ứng dụng (Super App) đóng vai trò trung tâm trong hành vi tiêu dùng. MoMo, với vị thế là nền tảng dẫn đầu, đã xây dựng một hệ sinh thái kỹ thuật phức hợp nhưng đồng nhất, cung cấp cho doanh nghiệp các giải pháp từ thanh toán trực tuyến, thanh toán tại quầy đến các mô hình quản lý tài chính doanh nghiệp và tiếp thị thông minh. Việc tích hợp hệ thống thanh toán MoMo vào vận hành doanh nghiệp không chỉ là một yêu cầu kỹ thuật mà là một quyết định chiến lược nhằm tiếp cận mạng lưới hơn 50 triệu người dùng và xử lý trung bình hơn một triệu giao dịch mỗi ngày. Bài viết này cung cấp một cái nhìn sâu sắc, toàn diện và thực tiễn về quy trình tích hợp MoMo, từ khía cạnh pháp lý, kiến trúc hệ thống đến các giao thức bảo mật và quy trình vận hành hậu tích hợp.

Kiến trúc tổng quan và vị thế chiến lược của MoMo trong hệ sinh thái Fintech

Vị thế của MoMo được củng cố bởi năng lực công nghệ mạnh mẽ và khả năng thích ứng cao với sự thay đổi của thị trường. Hệ thống của MoMo được thiết kế để đảm bảo tính liên tục của doanh nghiệp (Business Continuity) và khả năng mở rộng quy mô (System Capacity) vượt trội. Các giải pháp của MoMo không chỉ giới hạn ở thanh toán trực tuyến mà còn mở rộng sang các thiết bị IoT, AIoT và các giải pháp không cần tích hợp sâu (Non-Integration), đáp ứng nhu cầu của mọi loại hình doanh nghiệp từ siêu nhỏ đến các tập đoàn đa quốc gia.

1.1. Các chỉ số tăng trưởng và sức mạnh mạng lưới

Sự tin tưởng của các đối tác vào MoMo được minh chứng qua các con số tăng trưởng ổn định. Việc chia sẻ thị phần trong một mạng lưới đang phát triển mạnh mẽ là cơ hội để doanh nghiệp tối ưu hóa doanh thu và giảm thiểu rào cản thanh toán cho khách hàng.

  • Số lượng người dùng hoạt động: Trên 50.000.000 người. Ý nghĩa: Khả năng tiếp cận thị trường tiềm năng khổng lồ.

  • Số lượng giao dịch trung bình: Hơn 1.000.000 giao dịch/ngày. Ý nghĩa: Hệ thống vận hành ổn định và tin cậy.

  • Đối tác trực tuyến (Online Merchants): Hơn 1.000 doanh nghiệp. Ý nghĩa: Mạng lưới kết nối rộng khắp.

  • Điểm chấp nhận thanh toán (Offline Outlets): Hơn 50.000 điểm. Ý nghĩa: Khả năng bao phủ kênh bán hàng vật lý.

  • Hệ thống đại lý và đối tác: Hơn 910.000 đại lý và 626.000 đối tác. Ý nghĩa: Hạ tầng hỗ trợ nạp/rút và dịch vụ tài chính dày đặc.

1.2. Phân loại các giải pháp tích hợp cốt lõi

MoMo cung cấp một dải sản phẩm rộng, cho phép doanh nghiệp lựa chọn phương thức phù hợp với nguồn lực và mô hình kinh doanh. Sự linh hoạt này giúp tối ưu hóa trải nghiệm khách hàng (UX) trên mọi điểm chạm. Nếu đang so sánh MoMo với các cổng khác như VNPay, ZaloPay, xem bài tích hợp cổng thanh toán an toàn cho website.

  • Payment Gateway (Cổng thanh toán): Giải pháp All-in-One (AiO) cho phép tích hợp đa dạng phương thức thanh toán như ví MoMo, thẻ ATM nội địa, thẻ quốc tế (VISA/Master/JCB) và các nguồn tiền trả sau chỉ qua một quy trình kết nối duy nhất.

  • Automated Payments (Thanh toán tự động): Hỗ trợ cơ chế thanh toán một chạm (One-Click Payment) với xác thực một lần, phù hợp cho các dịch vụ đăng ký định kỳ.

  • SDK For Enhancements (MDK - MoMo Customized SDK): Bộ công cụ phát triển phần mềm được tối ưu hóa để tích hợp sâu vào ứng dụng di động của đối tác, mang lại hiệu năng cao và trải nghiệm mượt mà.

  • IoT & AIoT Solutions: Các giải pháp dành cho thiết bị thông minh như máy bán hàng tự động, Kiosk, SmartTV hoặc máy POS màn hình kép, hỗ trợ cả nhận diện khuôn mặt và quét mã QR.

  • Non-Integration Solutions: Dành cho doanh nghiệp không có đội ngũ kỹ thuật mạnh, bao gồm QR Code tĩnh (Static QR) và Liên kết thanh toán (Payment Link) để gửi qua SMS hoặc mạng xã hội.

Luồng tích hợp MoMo vào website: đăng ký, tạo giao dịch có chữ ký, khách thanh toán, nhận IPN, kiểm tra trạng thái, hoàn tiền

Chiến lược đăng ký và xác thực hồ sơ doanh nghiệp (M4B)

Để thiết lập sự hiện diện chính thức trong hệ sinh thái MoMo, doanh nghiệp phải đi qua cổng quản trị MoMo for Business (M4B). Đây không chỉ là một thủ tục hành chính mà là bước nền tảng để thiết lập các thông số định danh kỹ thuật và quản lý dòng tiền sau này.

2.1. Quy trình đăng ký tài khoản M4B

Quy trình bắt đầu tại địa chỉ business.momo.vn. Doanh nghiệp cần điền đầy đủ thông tin tài khoản bao gồm tên đăng nhập (dùng để tra cứu thông tin) và mật khẩu bảo mật cao (từ 8 đến 18 ký tự). Đối với các doanh nghiệp đã sử dụng các nền tảng quản lý như Haravan, Sapo hay CukCuk, việc đăng ký tài khoản M4B là bước bắt buộc để lấy các thông số kết nối API.

Lộ trình chuẩn hóa từ lúc đăng ký đến lúc chính thức vận hành (Go-live) gồm các bước sau:

  1. Đăng ký hồ sơ thương nhân (Merchant Profile).

  2. Tích hợp kỹ thuật trên môi trường Test (Sandbox).

  3. Hoàn tất kiểm thử SIT (System Integration Testing) trên môi trường Test.

  4. Thực hiện xác thực tài khoản doanh nghiệp thông qua hồ sơ pháp lý.

  5. Yêu cầu thông tin định danh (Credentials) cho môi trường thực tế (Production).

  6. Thực hiện kiểm thử chấp nhận người dùng (UAT) trên môi trường Production và yêu cầu xét duyệt cuối cùng.

  7. Được phê duyệt và chính thức triển khai dịch vụ.

2.2. Hồ sơ pháp lý và yêu cầu xác thực

Việc cung cấp hồ sơ chính xác quyết định tốc độ phê duyệt của đội ngũ QA và Pháp lý của MoMo. Các yêu cầu về hồ sơ bao gồm:

  • Đối với Doanh nghiệp: Giấy phép đăng ký kinh doanh (GPKD) bản gốc hoặc bản sao có công chứng, hình ảnh rõ nét.

  • Đối với Hộ kinh doanh cá thể: CMND/CCCD của người đại diện (ảnh mặt trước và mặt sau, không bị mờ hoặc cắt góc).

  • Đơn vị không có GPKD: CMND/CCCD và thông tin chủ cửa hàng (áp dụng cho các mô hình nhỏ, không có tư cách pháp nhân đầy đủ).

  • Hồ sơ bổ sung: Logo thương hiệu (định dạng 100x100 pixel), Giấy nộp thuế, Giấy ủy quyền.

Một đặc điểm quan trọng của hệ thống M4B là việc hỗ trợ ký hợp đồng điện tử, giúp đẩy nhanh quá trình onboarding mà không cần gặp mặt trực tiếp.

Kiến trúc kỹ thuật của giải pháp All-in-One (AiO) Unified API

Giải pháp AiO Unified API của MoMo đại diện cho sự chuẩn hóa trong kết nối thanh toán. Thay vì phải duy trì nhiều luồng kết nối cho các loại thẻ và nguồn tiền khác nhau, đối tác chỉ cần triển khai một API duy nhất.

3.1. Các tham số định danh kết nối (Credentials)

Trong môi trường tích hợp, đối tác sẽ làm việc với một bộ khóa bảo mật. Sự khác biệt giữa môi trường Test và Production nằm ở các giá trị khóa này và địa chỉ máy chủ (Domain).

  • Partner Code: Mã định danh duy nhất cho doanh nghiệp trong hệ thống MoMo.

  • Access Key: Khóa dùng để cấp quyền truy cập vào hệ thống API của MoMo.

  • Secret Key: Khóa bí mật dùng để tạo chữ ký điện tử (Signature) cho mỗi yêu cầu HTTP. Đây là thành phần quan trọng nhất trong việc đảm bảo tính toàn vẹn dữ liệu.

  • Public Key: Được sử dụng trong các thuật toán mã hóa dữ liệu RSA cho các giải pháp yêu cầu tính bảo mật cao hơn.

3.2. Cấu hình hạ tầng và mạng lưới (IP Whitelisting)

Hệ thống MoMo yêu cầu các đối tác cấu hình tường lửa để cho phép các dải địa chỉ IP cụ thể giao tiếp với máy chủ đối tác:

  • Môi trường Sandbox (Test): Domain test-payment.momo.vn. IP Đến: 210.245.113.71. IP Đi: 118.69.210.244, 118.68.171.198.

  • Môi trường Production: Domain payment.momo.vn. IP Đến: 118.69.212.158. IP Đi: 118.69.210.244, 116.103.110.134 (Cập nhật 11/09/2024).

Cơ chế bảo mật và giao thức chữ ký số (Digital Signature)

Bảo mật thông tin giao dịch là ưu tiên hàng đầu trong các hệ thống Fintech. MoMo sử dụng chữ ký số để xác thực dữ liệu, đảm bảo rằng thông tin không bị thay đổi bởi bên thứ ba.

4.1. Thuật toán HMAC-SHA256

MoMo sử dụng thuật toán băm HMAC-SHA256 để tạo chữ ký. Đây là một thuật toán đối xứng, sử dụng chung một Secret Key để tính toán. Công thức:

Signature = HMAC_SHA256(SecretKey, RawString)

4.2. Quy tắc tạo chuỗi dữ liệu gốc (Raw String)

  • Sắp xếp tham số: Các tên trường (key name) phải được sắp xếp theo thứ tự bảng chữ cái từ a-z.

  • Định dạng chuỗi: Nối các cặp key=value lại với nhau, phân cách bằng ký tự &.

  • Băm dữ liệu: Sử dụng Secret Key để băm chuỗi vừa tạo. Kết quả là một chuỗi thập lục phân gồm 64 ký tự.

Lưu ý: Tuyệt đối không bao giờ được lộ Secret Key trong mã nguồn phía Client (Frontend). Việc tạo signature phải luôn được thực hiện ở Server-side.

Quy trình tích hợp kỹ thuật One-Time Payments (captureWallet API)

Đây là luồng thanh toán phổ biến nhất, bao gồm khởi tạo giao dịch, điều hướng người dùng và xử lý kết quả.

5.1. Khởi tạo giao dịch (Initiate Payment)

Máy chủ đối tác gửi yêu cầu HTTP POST đến endpoint MoMo với các tham số: partnerCode, requestId, amount (Min 1.000 VND), orderId, orderInfo, redirectUrl, ipnUrl, requestType (captureWallet), và extraData. Có thể sinh requestId/orderId dạng UUID v4 bằng công cụ tạo UUID và xem phản hồi JSON của MoMo bằng công cụ định dạng JSON khi gỡ lỗi.

5.2. Điều hướng và Trải nghiệm người dùng

Sau khi gọi API thành công, MoMo trả về JSON chứa:

  • deeplink: Mở trực tiếp app MoMo (tối ưu App-to-App).

  • payUrl: URL trang thanh toán trên trình duyệt (tối ưu Desktop/Mobile Web).

  • qrCodeUrl: Dữ liệu để tạo mã QR hiển thị tại chỗ.

Cơ chế thông báo kết quả tức thời (IPN - Instant Payment Notification)

IPN là cơ chế quan trọng đảm bảo tính đồng bộ thông qua giao tiếp server-to-server, ngay cả khi người dùng mất kết nối sau khi trả tiền. Khi phát triển, có thể gửi thử payload tới endpoint IPN của bạn bằng công cụ test webhook để kiểm tra mã phản hồi.

  • Nguyên lý: MoMo gửi HTTP POST đến ipnUrl. Payload chứa resultCode, transId, amount, và signature.

  • Xử lý tại máy chủ: Bắt buộc xác thực chữ ký, đối soát orderId/amount và phản hồi mã HTTP 204 (No Content) trong vòng 15 giây.

Quản lý trạng thái và các nghiệp vụ sau thanh toán

  • Kiểm tra trạng thái (Check Status): Sử dụng khi không nhận được IPN hoặc kết quả điều hướng sau 30 giây.

  • Hoàn tiền (Refund): Áp dụng cho giao dịch thành công. Lưu ý orderId hoàn tiền phải là mã mới.

  • Hủy giao dịch (Reverse): Trả tiền ngay khi giao dịch đang chờ hoặc có lỗi kỹ thuật phía đối tác.

Hệ sinh thái MoMo Mini App - Chiến lược "App-in-App"

MoMo Mini App cho phép doanh nghiệp triển khai ứng dụng web-based ngay trên nền platform MoMo, giúp tiếp cận tập người dùng khổng lồ mà không cần đầu tư ứng dụng độc lập trên Store.

Giải pháp thanh toán Offline và thiết bị POS

MoMo mở rộng khả năng thanh toán vào không gian vật lý qua:

  • QR Code tĩnh (Static QR): Đơn giản nhất, khách quét mã và tự nhập số tiền.

  • QR Code động: POS sinh mã QR duy nhất cho từng hóa đơn, khách chỉ cần quét và xác nhận.

Kiểm soát trùng lặp và tính không thay đổi (Idempotency)

MoMo sử dụng trường requestId (nên dùng UUID V4) để kiểm soát trùng lặp trong 31 ngày. Nếu nhận cùng requestId, hệ thống trả về kết quả cũ thay vì trừ tiền lần nữa.

Hệ thống mã lỗi và chiến lược xử lý ngoại lệ

  • 2xx: Xử lý thành công.

  • 4xx: Lỗi phía đối tác (sai chữ ký, thiếu tham số).

  • 5xx: Lỗi hệ thống MoMo.

  • Mã 0: Thành công.

  • Mã 1001: Không đủ tiền.

  • Mã 1006: Người dùng hủy.

Quy trình kiểm thử SIT và UAT

Giai đoạn này sử dụng môi trường Sandbox và ứng dụng MoMo Test App. Tài khoản ví thử nghiệm mặc định có mật khẩu/OTP là 000000. Cần kiểm thử các luồng thành công, luồng lỗi (không đủ tiền, hết hạn QR) và luồng bảo mật (thay đổi số tiền).

Mã nguồn mẫu tham khảo (Code Samples)

Mã nguồn mẫu dưới đây dựa trên tài liệu và mã mẫu công khai của MoMo Developers (developers.momo.vn), đã sửa lỗi cú pháp và thống nhất thứ tự tham số trong chuỗi ký. Các giá trị partnerCode, accessKey, secretKey là khóa môi trường thử nghiệm (sandbox) công khai, không dùng cho production; khi chạy thật hãy lấy thông số trên trang M4B, lưu trong biến môi trường và đối chiếu lại tài liệu mới nhất của MoMo. Có thể tự kiểm tra chữ ký bằng công cụ tạo HMAC SHA256 (xuất dạng hex).

13.1. Node.js

JavaScript

// parameters
var partnerCode = "MOMO";
var accessKey = "F8BBA842ECF85";
var secretkey = "K951B6PE1waDMi640xX08PD3vg6EkVlz";
var requestId = partnerCode + new Date().getTime();
var orderId = requestId;
var orderInfo = "pay with MoMo";
var redirectUrl = "https://momo.vn/return";
var ipnUrl = "https://callback.url/notify";
var amount = "50000";
var requestType = "captureWallet"
var extraData = ""; 

// raw signature construction
var rawSignature = "accessKey="+accessKey+"&amount=" + amount+"&extraData=" + extraData+"&ipnUrl=" + ipnUrl+"&orderId=" + orderId+"&orderInfo=" + orderInfo+"&partnerCode=" + partnerCode +"&redirectUrl=" + redirectUrl+"&requestId=" + requestId+"&requestType=" + requestType

const crypto = require('crypto');
var signature = crypto.createHmac('sha256', secretkey)
   .update(rawSignature)
   .digest('hex');

const requestBody = JSON.stringify({
    partnerCode : partnerCode,
    accessKey : accessKey,
    requestId : requestId,
    amount : amount,
    orderId : orderId,
    orderInfo : orderInfo,
    redirectUrl : redirectUrl,
    ipnUrl : ipnUrl,
    extraData : extraData,
    requestType : requestType,
    signature : signature,
    lang: 'en'
});

const https = require('https');
const options = {
    hostname: 'test-payment.momo.vn',
    port: 443,
    path: '/v2/gateway/api/create',
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': Buffer.byteLength(requestBody)
    }
}
const req = https.request(options, res => {
    res.setEncoding('utf8');
    res.on('data', (body) => {
        console.log('payUrl: ' + JSON.parse(body).payUrl);
    });
})
req.write(requestBody);
req.end();

13.2. Go (Golang)

Go

package main
import (
	"bytes"
	"crypto/hmac"
	"crypto/sha256"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"net/http"
	"strconv"
	"github.com/sony/sonyflake"
)

type Payload struct {
	PartnerCode string `json:"partnerCode"`
	AccessKey   string `json:"accessKey"`
	RequestID   string `json:"requestId"`
	Amount      string `json:"amount"`
	OrderID     string `json:"orderId"`
	OrderInfo   string `json:"orderInfo"`
	RedirectUrl string `json:"redirectUrl"`
	IpnUrl      string `json:"ipnUrl"`
	ExtraData   string `json:"extraData"`
	RequestType string `json:"requestType"`
	Signature   string `json:"signature"`
}

func main() {
	flake := sonyflake.NewSonyflake(sonyflake.Settings{})
	a, _ := flake.NextID()
	b, _ := flake.NextID()

	var orderId = strconv.FormatUint(a, 16)
	var requestId = strconv.FormatUint(b, 16)
	var endpoint = "https://test-payment.momo.vn/v2/gateway/api/create"
	var secretKey = "PPuDXq1KowPT1ftR8DvlQTHhC03aul17"

	var payload = Payload{
		PartnerCode: "MOMOIQA420180417",
		AccessKey:   "SvDmj2cOTYZmQQ3H",
		RequestID:   requestId,
		Amount:      "1000",
		OrderID:     orderId,
		OrderInfo:   "momo all-in-one",
		RedirectUrl: "https://webhook.site/...",
		IpnUrl:      "https://webhook.site/...",
		ExtraData:   "",
		RequestType: "captureWallet",
	}

	var rawSignature bytes.Buffer
	rawSignature.WriteString("accessKey=" + payload.AccessKey + "&amount=" + payload.Amount + "&extraData=" + payload.ExtraData + "&ipnUrl=" + payload.IpnUrl + "&orderId=" + payload.OrderID + "&orderInfo=" + payload.OrderInfo + "&partnerCode=" + payload.PartnerCode + "&redirectUrl=" + payload.RedirectUrl + "&requestId=" + payload.RequestID + "&requestType=" + payload.RequestType)

	h := hmac.New(sha256.New, []byte(secretKey))
	h.Write(rawSignature.Bytes())
	payload.Signature = hex.EncodeToString(h.Sum(nil))

	jsonPayload, _ := json.Marshal(payload)
	resp, _ := http.Post(endpoint, "application/json", bytes.NewBuffer(jsonPayload))
	var result map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&result)
	fmt.Println("PayUrl is: ", result["payUrl"])
}

13.3. Python

Python

import json
import uuid
import requests
import hmac
import hashlib

endpoint = "https://test-payment.momo.vn/v2/gateway/api/create"
partnerCode = "MOMO"
accessKey = "F8BBA842ECF85"
secretKey = "K951B6PE1waDMi640xX08PD3vg6EkVlz"
orderInfo = "pay with MoMo"
redirectUrl = "https://webhook.site/..."
ipnUrl = "https://webhook.site/..."
amount = "50000"
orderId = str(uuid.uuid4())
requestId = str(uuid.uuid4())
requestType = "captureWallet"
extraData = ""

rawSignature = "accessKey=" + accessKey + "&amount=" + amount + "&extraData=" + extraData + "&ipnUrl=" + ipnUrl + "&orderId=" + orderId + "&orderInfo=" + orderInfo + "&partnerCode=" + partnerCode + "&redirectUrl=" + redirectUrl + "&requestId=" + requestId + "&requestType=" + requestType

h = hmac.new(bytes(secretKey, 'utf-8'), bytes(rawSignature, 'utf-8'), hashlib.sha256)
signature = h.hexdigest()

data = {
    'partnerCode': partnerCode,
    'requestId': requestId,
    'amount': amount,
    'orderId': orderId,
    'orderInfo': orderInfo,
    'redirectUrl': redirectUrl,
    'ipnUrl': ipnUrl,
    'lang': "vi",
    'extraData': extraData,
    'requestType': requestType,
    'signature': signature
}

data = json.dumps(data)
response = requests.post(endpoint, data=data, headers={'Content-Type': 'application/json'})
print(response.json()['payUrl'])

13.4. Ruby

Ruby

require 'net/https'
require 'uri'
require 'json'
require 'openssl'
require 'securerandom'

endpoint = "https://test-payment.momo.vn/v2/gateway/api/create"
partnerCode = "MOMO"
accessKey = "F8BBA842ECF85"
secretKey = "K951B6PE1waDMi640xX08PD3vg6EkVlz"
orderInfo = "pay with MoMo"
redirectUrl = "https://webhook.site/..."
ipnUrl = "https://webhook.site/..."
amount = "50000"
orderId = SecureRandom.uuid
requestId = SecureRandom.uuid
requestType = "captureWallet"
extraData = ""

rawSignature = "accessKey=" + accessKey + "&amount=" + amount + "&extraData=" + extraData + "&ipnUrl=" + ipnUrl + "&orderId=" + orderId + "&orderInfo=" + orderInfo + "&partnerCode=" + partnerCode + "&redirectUrl=" + redirectUrl + "&requestId=" + requestId + "&requestType=" + requestType

signature = OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), secretKey, rawSignature)

jsonRequest = {
    :partnerCode => partnerCode,
    :requestId => requestId,
    :amount => amount,
    :orderId => orderId,
    :orderInfo => orderInfo,
    :redirectUrl => redirectUrl,
    :ipnUrl => ipnUrl,
    :extraData => extraData,
    :requestType => requestType,
    :signature => signature,
    :lang => "vi"
}

uri = URI.parse(endpoint)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri.path, {'Content-Type' => 'application/json'})
request.body = jsonRequest.to_json
response = http.request(request)
puts JSON.parse(response.body)["payUrl"]

13.5. PHP (Khởi tạo & IPN)

PHP

// Initiate Payment
<?php
header('Content-type: text/html; charset=utf-8');
function execPostRequest($url, $data) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Content-Length: '. strlen($data)));
    curl_setopt($ch, CURLOPT_TIMEOUT, 30);
    $result = curl_exec($ch);
    curl_close($ch);
    return $result;
}

$endpoint = "https://test-payment.momo.vn/v2/gateway/api/create";
$partnerCode = 'MOMOBKUN20180529';
$accessKey = 'klm0567shj9qRrA';
$secretKey = 'at67qH6mk8w5Y1nAyMoYKMWACiEi2bsa';
$orderId = time(). "";
$requestId = time(). "";
$amount = "50000";
$orderInfo = "Thanh toán qua ví MoMo";
$redirectUrl = "https://yourdomain.com/return.php";
$ipnUrl = "https://yourdomain.com/ipn.php";
$requestType = "captureWallet";
$extraData = "";

$rawHash = "accessKey=". $accessKey. "&amount=". $amount. "&extraData=". $extraData. "&ipnUrl=". $ipnUrl. "&orderId=". $orderId. "&orderInfo=". $orderInfo. "&partnerCode=". $partnerCode. "&redirectUrl=". $redirectUrl. "&requestId=". $requestId. "&requestType=". $requestType;
$signature = hash_hmac("sha256", $rawHash, $secretKey);

$data = array('partnerCode' => $partnerCode, 'requestId' => $requestId, 'amount' => $amount, 'orderId' => $orderId, 'orderInfo' => $orderInfo, 'redirectUrl' => $redirectUrl, 'ipnUrl' => $ipnUrl, 'extraData' => $extraData, 'requestType' => $requestType, 'signature' => $signature);
$result = execPostRequest($endpoint, json_encode($data));
$jsonResult = json_decode($result, true);
header('Location: '. $jsonResult['payUrl']);
?>

// IPN Handling (ipn.php) — MoMo gửi kết quả dạng JSON trong body request
<?php
$accessKey = 'klm0567shj9qRrA';
$secretKey = 'at67qH6mk8w5Y1nAyMoYKMWACiEi2bsa';
$data = json_decode(file_get_contents('php://input'), true);
if (!$data) {
    $data = $_POST;
}
if (!empty($data)) {
    $rawHash = "accessKey=" . $accessKey . "&amount=" . $data["amount"] . "&extraData=" . $data["extraData"] . "&message=" . $data["message"] . "&orderId=" . $data["orderId"] . "&orderInfo=" . $data["orderInfo"] . "&orderType=" . $data["orderType"] . "&partnerCode=" . $data["partnerCode"] . "&payType=" . $data["payType"] . "&requestId=" . $data["requestId"] . "&responseTime=" . $data["responseTime"] . "&resultCode=" . $data["resultCode"] . "&transId=" . $data["transId"];
    $partnerSignature = hash_hmac("sha256", $rawHash, $secretKey);
    if (hash_equals($partnerSignature, (string) $data["signature"])) {
        if ((string) $data["resultCode"] === "0") {
            // Thành công: đối soát orderId/amount với đơn hàng, cập nhật trạng thái (bỏ qua nếu đã xử lý)
        }
    }
}
http_response_code(204);
?>

13.6. C# (.NET)

C#

// MoMoSecurity.cs
using System;
using System.Security.Cryptography;
using System.Text;

namespace MoMo {
    class MoMoSecurity {
        public string signSHA256(string message, string key) {
            byte[] keyByte = Encoding.UTF8.GetBytes(key);
            byte[] messageBytes = Encoding.UTF8.GetBytes(message);
            using (var hmacsha256 = new HMACSHA256(keyByte)) {
                byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);
                string hex = BitConverter.ToString(hashmessage);
                return hex.Replace("-", "").ToLower();
            }
        }
    }
}

// MoMoForm.cs
string endpoint = "https://test-payment.momo.vn/v2/gateway/api/create";
string partnerCode = "MOMO5RGX20191128";
string accessKey = "SvDmj2cOTYZmQQ3H";
string secretkey = "PPuDXq1KowPT1ftR8DvlQTHhC03aul17";
string orderId = Guid.NewGuid().ToString();
string requestId = Guid.NewGuid().ToString();
string amount = "50000";
// Build rawHash in alphabetical order...
MoMoSecurity crypto = new MoMoSecurity();
string signature = crypto.signSHA256(rawHash, secretkey);
// Send HTTP Post request...

Việc tích hợp MoMo không chỉ đơn thuần là việc cài đặt một phương thức thanh toán, mà là một hành trình chuyển đổi số toàn diện. Bằng cách tuân thủ các chuẩn mực kỹ thuật về signature, IPN, và bảo mật khóa, doanh nghiệp không chỉ xây dựng được một hệ thống thanh toán tin cậy mà còn tạo dựng niềm tin vững chắc nơi khách hàng trong kỷ nguyên số hóa hiện nay. Thành công của việc tích hợp nằm ở sự kết hợp giữa sự chính xác trong kỹ thuật và sự linh hoạt trong vận hành.

Doanh nghiệp không có đội kỹ thuật riêng có thể chọn gói website thương mại điện tử đã tích hợp sẵn thanh toán MoMo, VNPay cùng quản lý đơn hàng.

Mục lục

Câu hỏi thường gặp

Website cần chuẩn bị gì trước khi tích hợp thanh toán MoMo?

Bạn cần tài khoản Merchant MoMo, thông tin pháp lý theo yêu cầu đối tác, domain/hosting có HTTPS, server có thể nhận callback/webhook, và hệ thống quản lý đơn hàng. Chuẩn bị luồng thanh toán: tạo đơn, gọi API, nhận kết quả, cập nhật trạng thái và hoàn tiền (nếu có).

Tích hợp MoMo theo hình thức nào: QR, Redirect hay In-app?

Phổ biến nhất là Redirect/Deep link để khách thanh toán trên ứng dụng MoMo và quay lại website. QR phù hợp tại cửa hàng hoặc màn hình thanh toán. In-app áp dụng khi bạn có mobile app. Chọn theo trải nghiệm người dùng, thiết bị mục tiêu và khả năng xử lý callback của hệ thống.

MoMo cung cấp môi trường sandbox/test như thế nào để thử nghiệm?

MoMo thường có môi trường test (sandbox) với bộ key riêng, endpoint riêng và tài khoản test để mô phỏng thanh toán. Bạn nên kiểm thử đầy đủ: tạo thanh toán, callback thành công/thất bại, timeout, retry, và các tình huống người dùng đóng trang. Chỉ chuyển production sau khi đối soát ổn.

Những tham số quan trọng khi tạo yêu cầu thanh toán MoMo là gì?

Thông thường cần orderId/requestId duy nhất, amount, orderInfo, returnUrl (đưa khách quay lại), notifyUrl (server nhận kết quả), và chữ ký (signature) theo chuẩn MoMo. Nên lưu mapping giữa orderId và đơn hàng nội bộ để đối chiếu, tránh cập nhật nhầm khi có retry.

Callback/notifyUrl của MoMo hoạt động ra sao và cần xử lý gì?

notifyUrl là kênh server-to-server để MoMo báo kết quả, đáng tin hơn việc người dùng quay lại returnUrl. Bạn cần xác minh chữ ký, kiểm tra amount/orderId, cập nhật trạng thái đơn hàng theo idempotency (không cập nhật lặp), ghi log đầy đủ và trả response đúng để tránh MoMo gửi lại nhiều lần.

Làm sao đảm bảo bảo mật khi tích hợp MoMo API trên website?

Không đưa secret key lên frontend; mọi ký (sign) và gọi API nhạy cảm nên thực hiện ở backend. Bắt buộc dùng HTTPS, kiểm tra chữ ký ở cả chiều gửi và nhận, giới hạn IP/Rate limit nếu có, và lưu log an toàn. Tránh tin vào dữ liệu query từ trình duyệt nếu chưa xác thực.

Tích hợp MoMo có thể làm trên WordPress/WooCommerce không?

Có, thường bằng plugin cổng thanh toán MoMo hoặc tích hợp custom qua hook checkout. Bạn cần kiểm tra plugin có hỗ trợ notifyUrl, xác minh signature, cập nhật trạng thái đơn hàng tự động, và tương thích phiên bản WooCommerce/PHP. Nếu tùy biến, hãy đảm bảo quy trình hoàn tiền, hủy đơn và đối soát.

Nếu khách thanh toán thành công nhưng website không cập nhật đơn hàng thì xử lý thế nào?

Nguyên nhân hay gặp là notifyUrl lỗi, server chặn request, sai chữ ký, hoặc timeouts. Bạn nên dựa vào callback server-to-server, triển khai cơ chế “reconcile” định kỳ: đối chiếu giao dịch theo orderId/transactionId, cho phép admin re-check và cập nhật. Luôn ghi log raw callback để truy vết.

Có cần lưu thông tin thẻ/ ví của khách khi dùng MoMo không?

Không nên và thường không cần. Với MoMo, người dùng thanh toán trong app/ ví, website chỉ nhận kết quả giao dịch và mã tham chiếu. Bạn nên lưu transactionId, orderId, số tiền, trạng thái và thời gian để đối soát/hoàn tiền. Tránh thu thập dữ liệu nhạy cảm vượt nhu cầu.

Phí giao dịch và đối soát MoMo được quản lý như thế nào?

Phí phụ thuộc vào hợp đồng Merchant, ngành hàng và chính sách tại thời điểm ký kết. Bạn nên kiểm tra trong dashboard/ hợp đồng, đồng thời thiết kế hệ thống đối soát: lưu mã giao dịch, trạng thái, biên nhận, và xuất báo cáo theo ngày. Nếu cần hiển thị phí cho khách, phải minh bạch ngay ở checkout.

Bài viết liên quan

Hình ảnh đại diện của bài viết: Cách Kết Nối Dữ Liệu Cho Dashboard: Sheets, Kế Toán, API

Cách Kết Nối Dữ Liệu Cho Dashboard: Sheets, Kế Toán, API

Một Dashboard chỉ phát huy giá trị khi dữ liệu được kết nối chính xác và cập nhật kịp thời. Bài viết này giúp chủ doanh nghiệp hiểu các nguồn dữ liệu phổ biến, phương pháp kết nối, sự khác biệt giữa dữ liệu thời gian thực và đồng bộ định kỳ, cùng cách xây dựng một "single source of truth" cho hoạt động quản trị.

Hình ảnh đại diện của bài viết: Claude Opus 4.7: Điểm Mới, Giá Và Khác Gì Opus 4.6

Claude Opus 4.7: Điểm Mới, Giá Và Khác Gì Opus 4.6

Tóm tắt Claude Opus 4.7 của Anthropic bằng tiếng Việt: điểm mới về lập trình, đọc ảnh, mức effort xhigh, giới hạn an ninh mạng, giá và nơi dùng, vì sao chi phí thực tế có thể tăng, ai nên dùng và các bước chuyển từ Opus 4.6.

Hình ảnh đại diện của bài viết: Giá RAM và CPU 2026: vì sao tăng mạnh và kéo dài bao lâu?

Giá RAM và CPU 2026: vì sao tăng mạnh và kéo dài bao lâu?

Giá RAM, SSD và linh kiện máy tính tăng mạnh năm 2026 vì máy chủ AI hút năng lực sản xuất bộ nhớ. Bài giải thích cơ chế, số liệu dự báo của TrendForce, tác động lên laptop, PC và những điều nên cân nhắc khi mua máy.

Hình ảnh đại diện của bài viết: Gửi email qua Gmail SMTP từ website: hướng dẫn 5 ngôn ngữ

Gửi email qua Gmail SMTP từ website: hướng dẫn 5 ngôn ngữ

Hướng dẫn gửi email từ website qua Gmail SMTP bằng mật khẩu ứng dụng với Node.js, Python, Go, Ruby và PHP, kèm cách xử lý lỗi 535, giới hạn gửi của Gmail, quản lý bí mật và khi nào nên chuyển sang Gmail API.

Hình ảnh đại diện của bài viết: Danh sách dịch vụ miễn phí cho developer: cloud, API, CI/CD

Danh sách dịch vụ miễn phí cho developer: cloud, API, CI/CD

Tuyển chọn các dịch vụ có gói miễn phí cho lập trình viên theo nhu cầu: hosting, backend, cloud, database, lưu trữ, CI/CD, giám sát, email, xác thực và API AI, kèm giới hạn đã kiểm tra tháng 10/2026.

Hình ảnh đại diện của bài viết: Gemini 3.1 Pro là gì? Điểm mới, cách dùng và giới hạn

Gemini 3.1 Pro là gì? Điểm mới, cách dùng và giới hạn

Gemini 3.1 Pro là mô hình suy luận của Google ra mắt tháng 2/2026: thông số, điểm benchmark Google công bố, kênh truy cập, trạng thái preview và những điều nên kiểm chứng trước khi dùng cho công việc.

Hình ảnh đại diện của bài viết: Câu hỏi phỏng vấn Tester 2026 từ dự án thực tế

Câu hỏi phỏng vấn Tester 2026 từ dự án thực tế

30 câu hỏi phỏng vấn Tester/QA dạng tình huống kèm gợi ý trả lời: test khi không có tài liệu, ưu tiên theo rủi ro, test API, flaky test, viết bug report, kiểm thử tải và bảo mật cơ bản.

Hình ảnh đại diện của bài viết: Câu hỏi phỏng vấn DevOps 2026 nhà tuyển dụng hay hỏi

Câu hỏi phỏng vấn DevOps 2026 nhà tuyển dụng hay hỏi

30 câu hỏi phỏng vấn DevOps dạng tình huống kèm gợi ý trả lời: deploy không gián đoạn, migration database, tối ưu pipeline, pod khởi động lại, cảnh báo, sự cố production và mất region.

Bài cùng chuyên mục

Hình ảnh đại diện của bài viết: Cách Thiết Lập Email Tên Miền Trên Lark Từ A Đến Z (Cập Nhật 2027)

Cách Thiết Lập Email Tên Miền Trên Lark Từ A Đến Z (Cập Nhật 2027)

Từng bước gắn tên miền riêng vào Lark Mail: xác thực tên miền, khai báo bản ghi DNS, bật DKIM, thêm DMARC, tạo hộp thư cho nhân viên và đọc thư bằng Outlook. Kèm những lỗi hay gặp khiến thư không gửi được hoặc rơi vào spam.

Hình ảnh đại diện của bài viết: Tấn Phát Digital Có Mặt Trên Chợ Dev: Kho Hơn 1.000 Công Cụ Online Miễn Phí

Tấn Phát Digital Có Mặt Trên Chợ Dev: Kho Hơn 1.000 Công Cụ Online Miễn Phí

Kho công cụ online miễn phí của Tấn Phát Digital đã được duyệt và ra mắt trên Chợ Dev, sàn ra mắt và khám phá sản phẩm công nghệ dành cho lập trình viên, maker và AI builder Việt Nam. Bạn có thể dùng thử, bình chọn và góp ý trực tiếp trên trang sản phẩm.

Hình ảnh đại diện của bài viết: Gemini 4 Neon Ra Mắt: Điểm Mới, Giá Và Nơi Dùng Mô Hình Mới Của Google

Gemini 4 Neon Ra Mắt: Điểm Mới, Giá Và Nơi Dùng Mô Hình Mới Của Google

Tóm tắt tiếng Việt bài công bố Gemini 4 Neon của Google: mô hình nằm giữa Carbon và Hydrogen, giá 3 USD và 15 USD mỗi triệu token, ngữ cảnh 1 triệu token, bốn mức suy nghĩ, xếp hạng trên các bảng đánh giá, lập trình trong Google Antigravity, bản Neon for cyber, an toàn và nơi dùng trong Gemini API, Gemini for business, ứng dụng Gemini.

Hình ảnh đại diện của bài viết: Knowledge Work Plugins Là Gì? Bộ Plugin Của Anthropic Biến Claude Thành Trợ Lý Theo Vai Trò

Knowledge Work Plugins Là Gì? Bộ Plugin Của Anthropic Biến Claude Thành Trợ Lý Theo Vai Trò

Knowledge Work Plugins là kho plugin mã nguồn mở của Anthropic giúp Claude làm việc như trợ lý hiểu nghề cho bán hàng, marketing, chăm sóc khách hàng, tài chính, nhân sự, pháp chế và chủ doanh nghiệp nhỏ. Bài này giải thích plugin gồm những gì, 17 plugin của Anthropic, cách cài trên claude.ai, Cowork và Claude Code, cách sửa cho công ty và lưu ý khi dùng ở Việt Nam.

Bài trụ cột của chủ đề

Hình ảnh đại diện của bài viết: Hướng Dẫn Chọn Hosting & Domain Chuyên Nghiệp Cho Website Doanh Nghiệp Nhỏ
Bài trụ cột

Hướng Dẫn Chọn Hosting & Domain Chuyên Nghiệp Cho Website Doanh Nghiệp Nhỏ

Khám phá lộ trình xây dựng hạ tầng kỹ thuật vững chắc cho website doanh nghiệp với các tư vấn chuyên môn về tên miền quốc gia, công nghệ hosting hiện đại

Bài mới nhất cùng chuyên mục

Hình ảnh đại diện của bài viết: REA Là Gì? Hướng Dẫn Dùng REA (Reverse Engineer Anything) Dịch Ngược Phần Mềm Bằng AI

REA Là Gì? Hướng Dẫn Dùng REA (Reverse Engineer Anything) Dịch Ngược Phần Mềm Bằng AI

REA (Reverse Engineer Anything) là bộ công cụ mã nguồn mở giúp trợ lý AI lập trình tìm hiểu một ứng dụng, trò chơi hay trang web hoạt động thế nào mà không cần mã nguồn. Bài này giải thích dịch ngược phần mềm cho người mới, cách REA hoạt động qua MCP, những gì REA phân tích được, cài đặt từng bước, cách hỏi trợ lý, ví dụ thật trên rea.tools, so sánh với Craft Anything và giới hạn pháp lý.

Hình ảnh đại diện của bài viết: Anthropic Thay Git Bằng Scion: Bài Học Quản Lý Mã Nguồn Thời AI Agent

Anthropic Thay Git Bằng Scion: Bài Học Quản Lý Mã Nguồn Thời AI Agent

Tóm tắt tiếng Việt bài viết của Anthropic về Scion, hệ thống quản lý mã nguồn tự xây để thay git cho monorepo khi lượng thay đổi tăng từ 2.500 lên hơn 30.000 mỗi ngày: vì sao git quá tải, nguyên tắc thiết kế, kiến trúc checkout nhiều tầng, kết quả, bài học và điều đội lập trình Việt Nam áp dụng được.

Hình ảnh đại diện của bài viết: Claude Fable 5.2 Ra Mắt: Điểm Mới, Giá Và Cách Dùng Trong Claude Code

Claude Fable 5.2 Ra Mắt: Điểm Mới, Giá Và Cách Dùng Trong Claude Code

Tóm tắt tiếng Việt bài công bố Claude Fable 5.2 và Claude Mythos 5.2 của Anthropic: cùng một mô hình nền khác lớp bảo vệ, nhanh hơn 30%, giá 8 USD và 40 USD mỗi triệu token, điểm đánh giá so với Opus 5.5, GPT-6 Astra, Gemini 4 Carbon, các thử nghiệm lập trình, khoa học, an toàn và cách dùng trong Claude Code.

Hình ảnh đại diện của bài viết: MCP Là Gì? Hướng Dẫn Cài Và Dùng MCP Server Từ A–Z Cho Người Mới

MCP Là Gì? Hướng Dẫn Cài Và Dùng MCP Server Từ A–Z Cho Người Mới

Hướng dẫn MCP từ A–Z cho người mới: Model Context Protocol là gì, host, client, server, tools, resources, prompts, server cục bộ và từ xa, cách cài MCP server trên Claude Desktop, Claude Code, Codex, Cursor, Antigravity, tìm server ở đâu, tiết kiệm ngữ cảnh, bảo mật và lỗi thường gặp.

TAN PHATDIGITAL