Tích Hợp Payoo Gateway: Kết Nối 50,000 Điểm Thanh Toán Offline
Một trong những rào cản lớn nhất của thương mại điện tử tại Việt Nam chính là: Khách hàng không rành công nghệ hoặc không có tài khoản ngân hàng. Họ muốn mua hàng online, nhưng chỉ muốn... trả tiền mặt.
Ship COD (Giao hàng thu tiền) là một giải pháp, nhưng rủi ro "bom hàng" rất cao. Giải pháp tối ưu hơn? Hãy tích hợp Payoo Gateway. Payoo sở hữu mạng lưới hơn 50,000 điểm giao dịch tại các cửa hàng tiện lợi (Circle K, FamilyMart, MiniStop...), cho phép khách đặt hàng online và ra cửa hàng gần nhà để thanh toán tiền mặt.
1. Payoo - Cầu Nối Giữa Online và Offline (O2O)
- Thanh toán tại quầy: Khách đặt hàng trên web -> Nhận mã thanh toán -> Ra FamilyMart/Circle K đưa mã và trả tiền mặt.
- Thanh toán hóa đơn: Payoo là đơn vị số 1 về thu hộ điện, nước, internet, học phí, vay tiêu dùng.
- Hệ sinh thái đa dạng: Bên cạnh thanh toán tại quầy, Payoo cũng hỗ trợ thẻ nội địa, thẻ quốc tế và Ví điện tử Payoo.
2. Quy Trình Đăng Ký Merchant Payoo
- Liên hệ Payoo Business.
- Ký hợp đồng dịch vụ chấp nhận thanh toán.
- Nhận bộ tài liệu tích hợp và tài khoản Sandbox:
<li><code>BusinessUsername</code>: Tên đăng nhập API.
- <code>ShopID</code>: Mã định danh cửa hàng.
- <code>ChecksumKey</code>: Khóa bí mật.
</li>
3. Hướng Dẫn Tích Hợp Kỹ Thuật (Payoo API)
Payoo cung cấp API dạng SOAP và REST. Trong bài này chúng ta sẽ dùng REST API cho đơn giản.
Bước 1: Tạo XML đơn hàng (Order XML)
Đặc thù của Payoo là dữ liệu đơn hàng phải được đóng gói trong chuỗi XML (kể cả khi dùng REST).
<code>$orderXml = ' <shops> <shop> <session>' . $orderId . '</session> <username>' . $businessUsername . '</username> <shop_id>' . $shopId . '</shop_id> <shop_title>JAY Store</shop_title> <shop_domain>https://jaystore.com</shop_domain> <shop_back_url>' . $returnUrl . '</shop_back_url> <order_no>' . $orderId . '</order_no> <order_cash_amount>' . $amount . '</order_cash_amount> <order_description>' . $orderInfo . '</order_description> <validity_time>' . date('YmdHis', strtotime('+1 day')) . '</validity_time> <notify_url>' . $notifyUrl . '</notify_url> </shop> </shops>';
// Mã hóa check sum (SHA512) $checksum = hash('sha512', $checksumKey . $orderXml);</code></pre>
Bước 2: Redirect sang cổng thanh toán Payoo
<pre><code>// Endpoint Sandbox $payooUrl = "https://newsandbox.payoo.com.vn/v2/paynow/order/create";
// Gửi POST Request (Form submit) echo '<form action="' . $payooUrl . '" method="POST"> <input type="hidden" name="data" value="' . base64_encode($orderXml) . '"> <input type="hidden" name="checksum" value="' . $checksum . '"> <input type="hidden" name="refer" value="jaystore.com"> <button type="submit">Thanh toán qua Payoo</button> </form>'; // Có thể dùng JavaScript để tự động submit form này</code></pre>
Bước 3: Xử lý IPN (Notify URL)
<p>Vì khách hàng có thể trả tiền mặt tại cửa hàng (offline), nên việc xử lý IPN là BẮT BUỘC (Web của bạn không thể chờ khách đi ra cửa hàng rồi mới redirect về).
<code>// File: payoo_ipn.php // Payoo sẽ gọi vào URL này khi khách vừa thanh toán xong tại quầy $data = $_POST['data']; // Webhook trả về XML base64 $checksum = $_POST['checksum'];
// Verify checksum if (hash('sha512', $checksumKey . $data) == $checksum) { // Checksum đúng - Giải mã XML $xmlData = base64_decode($data); $xmlObject = simplexml_load_string($xmlData); $status = $xmlObject->status; // 1: Thành công $orderNo = $xmlObject->order_no; if ($status == 1) { // Cập nhật trạng thái đơn hàng = Đã thanh toán echo "NOTIFY_RECEIVED"; } }</code></pre>
4. Tại Sao Nên Chọn JAYbranding Để Tích Hợp Payoo?
<p>Payoo có cấu trúc dữ liệu XML và quy trình O2O (Online to Offline) khá phức tạp so với các ví điện tử thuần túy. JAYbranding sẽ giúp bạn:
- ✅ Xử lý hàng chờ: Khi khách chọn "Thanh toán tại cửa hàng", đơn hàng trên web sẽ ở trạng thái "Chờ thanh toán" (Pending). Hệ thống của JAYbranding sẽ tự động hủy đơn nếu quá 24h khách không ra cửa hàng đóng tiền.
- ✅ Gửi mã thanh toán: Tự động gửi SMS/Email chứa mã thanh toán (Billing Code) cho khách hàng để họ tiện đưa cho nhân viên cửa hàng tiện lợi.
- ✅ Bảo mật: Đảm bảo toàn vẹn dữ liệu XML để không bị lỗi checksum.
📞 Tiếp cận khách hàng Offline ngay! Hotline tư vấn: 0899991131
FAQ Về Payoo
[faqs]
#### Tôi kinh doanh online 100% có cần Payoo không?
Rất cần. Có một lượng lớn khách hàng (học sinh, người lớn tuổi) không có thẻ ngân hàng/ví điện tử. Payoo giúp bạn không bỏ lỡ đối tượng này.
#### Phí thanh toán tại cửa hàng ai chịu?
Doanh nghiệp chịu phí giao dịch (khoảng 2% - 3%). Khách hàng ra đóng tiền thường không mất thêm phí (tùy chính sách của bạn).
#### Thời gian nhận được tiền từ Payoo?
Payoo đối soát và chuyển tiền định kỳ (thường là T+1 hoặc T+2) tổng hợp tất cả các giao dịch.
[/faqs]