Tích Hợp OnePay Gateway: Giải Pháp Thanh Toán Thẻ Quốc Tế Visa/Mastercard

Khi doanh nghiệp của bạn bắt đầu vươn ra thị trường quốc tế (Global) hoặc kinh doanh các sản phẩm giá trị cao (Tour du lịch, Khách sạn, Vé máy bay), rào cản lớn nhất chính là: Làm sao nhận tiền từ khách nước ngoài?

Các ví điện tử nội địa như MoMo, ZaloPay thường không hỗ trợ thẻ tín dụng quốc tế phát hành tại nước ngoài. Đây chính là lúc bạn cần đến OnePay - Cổng thanh toán chuyên trị các loại thẻ Visa/Mastercard/Amex/JCB với tiêu chuẩn bảo mật quốc tế.

1. OnePay - Đối Tác Của MasterCard Quốc Tế

- Chuyên gia thẻ: Hỗ trợ thanh toán hầu hết các loại thẻ trên thế giới: Visa, MasterCard, American Express (Amex), JCB, UnionPay.

- Đa tiền tệ: Chấp nhận thanh toán bằng USD, EUR, AUD... và tự động quy đổi về VND cho doanh nghiệp.

- Bảo mật 3D-Secure: Tích hợp xác thực 2 lớp (OTP gửi về điện thoại chủ thẻ) giúp giảm thiểu tối đa rủi ro Chargeback (Hoàn tiền do gian lận).

- Thanh toán định kỳ (Recurring): Tính năng Tokenization cho phép tự động trừ tiền hàng tháng (thích hợp cho bán Hosting, Subscription).

2. Quy Trình Đăng Ký Merchant OnePay

Do liên quan đến dòng tiền quốc tế, quy trình xét duyệt của OnePay khá nghiêm ngặt:

- Liên hệ bộ phận Sales OnePay.

- Cung cấp hồ sơ: GPKD, Mẫu website, Chính sách hoàn tiền (Refund Policy), Chính sách giao hàng (Shipping Policy). Website BẮT BUỘC phải có tiếng Anh.

- Thẩm định: OnePay và Ngân hàng (Vietcombank) sẽ thẩm định rủi ro của doanh nghiệp.

- Cấp tài khoản Test (Sandbox) và Production (Live).

3. Hướng Dẫn Tích Hợp Kỹ Thuật (OnePay API)

OnePay cung cấp 2 cổng chính: Nội địa (Domestic) và Quốc tế (International). Về mặt kỹ thuật, chúng khá giống nhau, chỉ khác Endpoint URL.

Bước 1: Tạo Request URL

<code>// Config cho cổng Quốc Tế (International) $vpc_URL = "https://mtf.onepay.vn/vpcpay/vpcpay.op"; // Sandbox $SECURE_SECRET = "A1D3..."; // Hash Key $vpc_Merchant = "TESTONEPAY"; // Merchant ID $vpc_AccessCode = "6BE5...";

$vpc_Amount = 100 * 100; // Số tiền (VND, nhân 100) $vpc_ReturnURL = "https://yourwebsite.com/onepay_dr.php";

$md5HashData = ""; $data = array( 'vpc_AccessCode' => $vpc_AccessCode, 'vpc_Amount' => $vpc_Amount, 'vpc_Command' => 'pay', 'vpc_Locale' => 'en', // Giao diện tiếng Anh cho khách quốc tế 'vpc_MerchTxnRef' => date('YmdHis'), // Mã đơn hàng 'vpc_Merchant' => $vpc_Merchant, 'vpc_OrderInfo' => "Order #999", 'vpc_ReturnURL' => $vpc_ReturnURL, 'vpc_Version' => '1' );

ksort($data);

$appendAmp = 0; foreach ($data as $key => $value) { if (strlen($value) > 0) { if ($appendAmp == 0) { $md5HashData .= $key . "=" . $value; $appendAmp = 1; } else { $md5HashData .= "&" . $key . "=" . $value; } } }

// Tạo chữ ký (Checksum) $vpc_SecureHash = strtoupper(hash_hmac('sha256', $md5HashData, pack('H*', $SECURE_SECRET)));

$link = $vpc_URL . "?" . $md5HashData . "&vpc_SecureHash=" . $vpc_SecureHash;

// Redirect khách hàng header("Location: " . $link);</code></pre>

Bước 2: Xử Lý Kết Quả (DR - Digital Receipt)

<p>Khi khách hàng quay lại website, bạn cần kiểm tra mã lỗi <code>vpc_TxnResponseCode</code>.

<code>// File: onepay_dr.php $vpc_Txn_Secure_Hash = $_GET["vpc_SecureHash"]; unset($_GET["vpc_SecureHash"]);

// ... (Logic sort và tạo lại hash giống bước 1 để so sánh) ...

if ($hashValidated && $txnResponseCode == "0") { // 0: Giao dịch thành công echo "Success!"; } elseif ($txnResponseCode != "0") { // Xử lý các mã lỗi phổ biến // 1: Bank Declined (Ngân hàng từ chối) // 3: No Reply (Mất kết nối) // 7: Insufficient Funds (Không đủ tiền) echo "Giao dịch thất bại. Mã lỗi: " . $txnResponseCode; }</code></pre>

4. OnePay Tokenization (Thanh Toán Định Kỳ)

<p>Đây là tính năng mạnh mẽ nhất của OnePay. Thay vì bắt khách nhập lại thẻ mỗi tháng, bạn có thể lưu "Token" (Mã hóa của thẻ) để tự động trừ tiền.

- Lần đầu: Khách thanh toán và chọn "Lưu thẻ". OnePay trả về <code>vpc_Token</code>.

- Lần sau: Bạn gửi Request kèm <code>vpc_Token</code> thay vì bắt khách nhập số thẻ. OnePay sẽ trừ tiền thẻ tương ứng với Token đó.

5. Dịch Vụ Của JAYbranding

Tích hợp thanh toán quốc tế chứa đựng nhiều rủi ro về bảo mật và vận hành. JAYbranding hỗ trợ:

- ✅ Tư vấn đa tiền tệ: Thiết lập hệ thống hiển thị giá USD cho khách Mỹ, EUR cho khách Âu nhưng thu về VND.

- ✅ Xử lý IPN 2 chiều: Đảm bảo đơn hàng được cập nhật kể cả khi khách tắt trình duyệt.

- ✅ Giao diện Checkout: Tùy biến giao diện nhập thẻ ngay trên website (dùng iFrame) để tăng trải nghiệm thay vì Redirect.

📞 Sẵn sàng bán hàng toàn cầu? Liên hệ JAYbranding: 0899991131

FAQ Về OnePay

[faqs]

#### Phí giao dịch thẻ quốc tế là bao nhiêu?

Khoảng 2.5% - 3.5% + Phí cố định/giao dịch. Mức phí này cao hơn nội địa do phải trả cho tổ chức thẻ quốc tế (Visa/Master).

#### Bao lâu thì tôi nhận được tiền?

Với thẻ quốc tế, thời gian đối soát thường lâu hơn, khoảng T+7 đến T+14 (tùy mức độ rủi ro của ngành hàng) để dự phòng trường hợp khách khiếu nại (Chargeback).

[/faqs]