Description
Coins Pay for WooCommerce allows merchants to accept payments through Coins Wallet.
Customers are redirected to the Coins WebPay checkout page to complete their payment securely.
Requirements
- WordPress 6.5 or above
- WooCommerce 8.0 or above
- PHP 7.4 or above
- cURL with OpenSSL enabled on your web hosting
- A valid Coins merchant account (sign up here)
- HTTPS-enabled website recommended for production use (required for webhooks)
Features
- Simple redirect-based payment flow — Customers are redirected to the Coins WebPay page to pay with their Coins Wallet.
- Sandbox and production mode — Test your integration with sandbox mode before going live.
- Automatic order status updates — Webhooks keep your WooCommerce orders in sync with payment status in real time.
- Refund support — Process full or partial refunds directly from the WooCommerce order admin.
- Optional payment fee — Add a configurable payment processing fee displayed at checkout.
- Debug logging — Enable detailed logs for troubleshooting integration issues.
- WooCommerce HPOS compatible — Fully supports High-Performance Order Storage.
- WooCommerce Blocks compatible — Works with both the classic checkout shortcode and the new Blocks-based checkout.
External services
This plugin connects to the Coins.ph payment API to process payments and refunds.
What data is sent and when
- During checkout: When a customer places an order, the plugin sends order amount, currency, fee amount, product names, quantities, and a unique request ID to the Coins API (
https://api.pro.coins.ph) to create a payment session. The customer is then redirected to the Coins WebPay page to complete payment. - During refunds: When a merchant initiates a refund from WooCommerce, the plugin sends the refund amount, currency, reason, and checkout reference to the Coins API.
- Webhooks (inbound): Coins.ph sends payment and refund status notifications to your site’s webhook endpoint. No additional data is sent from your site during this process.
In sandbox/test mode, data is sent to the sandbox API (https://api.9001.pl-qa.coinsxyz.me) instead of the production endpoint.
Service provider
This service is provided by Coins.ph (DCPAY PHILIPPINES, INC.), a BSP-licensed e-money issuer in the Philippines.
- Service website: https://coins.ph
- User Agreement (Terms of Service): https://coins.ph/en-ph/legal#user-agreement
- Privacy and Data Protection Policy: https://coins.ph/en-ph/legal#privacy
Installation
- Upload the plugin to the
/wp-content/plugins/coins-pay-for-woocommercedirectory, or install through the WordPress plugin screen. - Activate the plugin through the « Plugins » screen in WordPress.
- Go to WooCommerce > Settings > Payments > Coins Pay.
- Enter your API keys from the Coins merchant dashboard.
- Copy the Webhook URL shown on the settings page and configure it in your Coins merchant dashboard.
- Enable the payment method and start accepting payments.
Getting your API keys
- Log in to your Coins merchant dashboard.
- Navigate to the API / Integration section.
- Generate or copy your API Key and Secret Key.
- For testing, use the sandbox keys; for production, use the live keys.
FAQ
-
What currencies are supported?
-
Currently, Coins Pay supports PHP (Philippine Peso) payments.
-
Do customers need a Coins account?
-
Yes, customers need a Coins Wallet account to complete payments. They will be prompted to log in or register on the Coins WebPay checkout page.
-
How do I test the plugin?
-
Enable Sandbox mode in the plugin settings and use your sandbox API keys. This allows you to simulate the full payment flow without processing real transactions.
-
How do webhooks work?
-
When a payment status changes (e.g., completed, failed, cancelled), Coins sends a webhook notification to your site. The plugin automatically updates the WooCommerce order status. Make sure the Webhook URL from your plugin settings is configured in your Coins merchant dashboard.
-
Does the webhook require HTTPS?
-
For production use, yes. Your webhook endpoint should be accessible over HTTPS so payment notifications are transmitted securely.
-
Can I process refunds?
-
Yes. Go to the WooCommerce order screen, click « Refund », enter the amount, and click « Refund via Coins Pay ». The refund is processed through the Coins API and the order status updates automatically once confirmed.
-
Is there a transaction fee?
-
The plugin allows you to configure an optional payment fee (under Coins Pay settings) that is displayed to customers at checkout. Coins may also charge a separate service fee on their platform — consult your Coins merchant agreement for details.
-
What happens if the customer closes the payment page?
-
If the customer closes the Coins WebPay page without completing payment, the order remains in « Pending payment » status. The customer can retry by returning to their order page.
-
Is the plugin compatible with WooCommerce Blocks checkout?
-
Yes, the plugin fully supports the new WooCommerce Blocks-based checkout as well as the classic checkout shortcode.
-
Where can I find debug logs?
-
Enable Debug log in the plugin settings. Logs are written to WooCommerce > Status > Logs and can be filtered by source
coins-pay.
Avis
Il n’y a aucun avis pour cette extension.
Contributeurs/contributrices & développeurs/développeuses
« Coins Pay for WooCommerce » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
ContributeursTraduisez « Coins Pay for WooCommerce » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal des modifications
1.0.0
- Initial stable release.
- Redirect-based payment flow via Coins WebPay.
- Sandbox and production mode support.
- Webhook-based automatic order status updates.
- Full and partial refund support via Coins API.
- Optional configurable payment fee.
- WooCommerce HPOS (High-Performance Order Storage) compatible.
- WooCommerce Blocks checkout compatible.
- Debug logging for troubleshooting.
