AparimitLabs Payment Gateway for DPO Pay

开发者	aparimitlabs
更新时间	2026年9月26日 03:18
PHP版本:	8.2 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

1.0.0

详情介绍:

AparimitLabs Payment Gateway for DPO Pay is a production-grade payment gateway that integrates DPO Pay (Direct Pay Online) — the leading payment service provider across Africa and the Middle East — into your WooCommerce store. GitHub Repository: https://github.com/aparimitlabs/aparimitlabs-payment-gateway-dpo The integration follows DPO Pay's recommended Option A flow: CreateToken → Hosted Payment Page → VerifyToken. All API communication is XML-over-HTTP using WordPress's native wp_remote_post() function. Built following strict Aparimitlabs architectural standards: PSR-4 autoloading, HPOS (High-Performance Order Storage) compatibility, a dedicated transaction log table, and zero raw cURL dependencies. Payment Flow

Customer selects DPO Pay at checkout (fully compatible with WooCommerce Blocks) and clicks Place Order.
The plugin calls createToken on the DPO API to generate a secure transaction token.
Customer is redirected to DPO Pay's hosted payment page (payv3.php?ID={token}).
Customer completes payment on DPO's PCI-DSS secure hosted environment.
Primary: DPO redirects the customer back to your store. The plugin calls verifyToken to confirm payment status before completing the order.
Fallback (PTN): If the customer closes their browser, DPO sends a background XML Webhook ping to the plugin, which independently verifies the token and marks the order paid.

Key Features

WooCommerce Blocks Ready: Fully integrated with the modern WooCommerce Blocks checkout experience.
DPO Pay Hosted Payment Pages: Customer payment data is entered on DPO's PCI-DSS certified hosted page — no card data passes through your server.
Background Webhook (PTN) Support: Orders are guaranteed to update to "Processing" in the background even if the customer closes their browser before returning to your site.
VerifyToken Reconciliation: Every returning customer session and webhook ping is independently verified against the DPO API before the WooCommerce order is marked complete, preventing spoofing.
Sandbox & Live Environments: Switch between the DPO sandbox and live environment from the WooCommerce gateway settings panel.
API Request Logging: Built-in WooCommerce status logger for API requests and XML responses to aid troubleshooting.
Transaction Log Table: Every createToken and verifyToken result is persisted to a dedicated wp_dpo_transactions database table for reporting and auditing.
HPOS Compatible: Explicitly declares High-Performance Order Storage compatibility.
WordPress HTTP API Only: All outbound HTTP communication uses wp_remote_post(). No raw cURL.

安装:

Upload the aparimitlabs-payment-gateway-dpo folder to /wp-content/plugins/, or install directly via Plugins > Add New.
Activate the plugin.
Navigate to WooCommerce > Settings > Payments and click Manage next to DPO Pay.
Select your environment (Sandbox or Live), enter your Company Token and Service Type, and save.

屏幕截图:

升级注意事项:

1.0.0 Initial release of AparimitLabs Payment Gateway for DPO Pay.

常见问题:

Where do I get my DPO Pay Company Token?

Log in to your DPO Pay merchant portal at https://portal.dpopay.com, navigate to your account settings, and copy your Company Token. It is a UUID in the format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.

What is the Service Type?

The Service Type is a numeric ID assigned by DPO Pay that identifies the category of goods or services you sell. It is provided to you by DPO Pay when your account is set up (e.g., 54841 for Test Product in the sandbox environment).

How do I test the integration?

Set Environment to Sandbox and use one of the DPO Pay sandbox Company Tokens and Service Types provided in your DPO support credentials. The plugin automatically routes both live and sandbox transactions to the correct secure.3gdirectpay.com endpoint based on your token.

Is this compatible with WooCommerce HPOS?

Yes. The plugin explicitly declares HPOS compatibility and uses wc_get_order(), $order->update_meta_data(), and $order->payment_complete() throughout.

What happens if the customer closes the browser on the DPO payment page?

Don't worry! The plugin implements DPO Pay's Payment Token Notification (PTN) Webhook. DPO Pay will secretly ping your WooCommerce store in the background the moment the payment succeeds, and the plugin will automatically update the order status to Processing.

Does this plugin store card numbers or payment credentials?

No. All card and wallet data is entered and stored on DPO Pay's PCI-DSS certified hosted environment. This plugin only stores the DPO transaction token, order amount, currency, result code, and status in the local wp_dpo_transactions table.

更新日志: