Paymento – Non-Custodial Crypto Payment Gateway for WooCommerce

Paymento – The Non-Custodial Crypto Payment Gateway for WooCommerce

Paymento allows businesses and individuals to accept cryptocurrency payments directly into their own wallets, eliminating third-party risks, custody issues, and unnecessary fees.

🌟 Key Features:
✔ Direct Wallet Payments – No intermediaries, full control over your funds.
✔ Multi-Chain Support – Accept Bitcoin, Ethereum, USDT (ERC20 & TRC20), and more.
✔ Secure & Private – Non-custodial solution with no private key access required.
✔ Easy WooCommerce Integration – Install, configure, and start accepting crypto in minutes.
✔ WooCommerce Blocks Compatible – Works with both classic and modern block-based checkout.
✔ HPOS Compatible – Full support for High-Performance Order Storage.
✔ Low Transaction Fees – Save costs compared to traditional payment gateways.
✔ Developer-Friendly API – Expand functionality with simple API calls.

Requirements

• WordPress 6.0 or higher
• WooCommerce 8.0 or higher
• PHP 8.0 or higher
• A Paymento merchant account

Configuration

1. Go to WooCommerce > Settings > Payments.
2. Find “Paymento” in the list and click “Manage”.
3. Enable the payment method by checking the “Enable/Disable” box.
4. Fill in the following required fields:
   • Title: The name of the payment method displayed to customers
   • Description: A brief description of the payment method displayed to customer, you can mention the assets that you want to accept.
   • API Key: Your Paymento API Key (available in your Paymento merchant dashboard)
   • Secret Key: Your Paymento Secret Key (available in your Paymento merchant dashboard)
5. Choose your preferred Confirmation Type:
   • Redirect Immediately and Hold Invoice (Recommended)
   • Wait for Payment Confirmation
6. Optionally enable Debug Log for troubleshooting.
7. Click “Save changes” to apply your settings.

Usage

Once configured, the Paymento payment option will appear on your WooCommerce checkout page. Customers can select this option to pay with cryptocurrency.

Order Process

1. Customer selects Paymento as the payment method and completes the order.
2. They are redirected to the Paymento payment page to complete the transaction.
3. After payment, the customer is redirected back to your store.
4. The order status is updated based on the payment status and your chosen confirmation type.

External Services

This plugin connects to the Paymento API to process cryptocurrency payments. Paymento is a non-custodial payment gateway that enables WooCommerce stores to accept payments in Bitcoin, Ethereum, USDT, and other cryptocurrencies.

📌 Data Sent to Paymento API

The plugin makes exactly four types of request to the Paymento API, each with a specific trigger. No request is made on ordinary page views.

• Submitting Payment Requests

  • Endpoint: https://api.paymento.io/v1/payment/request
  • Triggered when a customer places an order and chooses Paymento at checkout.
  • Data sent: order total, currency, order ID, the return URL on your store, and your API Key.
  • Paymento returns a payment token used to generate the invoice.

• Payment Verification

  • Endpoint: https://api.paymento.io/v1/payment/verify
  • Triggered only when Paymento notifies your store of a paid order via webhook (IPN).
  • Data sent: the payment token for that order, and your API Key.
  • Used to confirm the notification is genuine before the order is completed.

• Fetching Merchant Information

  • Endpoint: https://api.paymento.io/v1/ping/merchant/
  • Triggered only when an administrator saves the gateway settings in WooCommerce.
  • Data sent: your API Key. Returns your registered merchant name and account status, which are stored locally and shown on the settings screen.

• Setting Callback URLs

  • Endpoint: https://api.paymento.io/v1/payment/settings/
  • Triggered only when an administrator saves the gateway settings, after the merchant check above succeeds.
  • Data sent: your store’s webhook (IPN) URL and your API Key, so Paymento knows where to send payment notifications.

📌 Customer Redirect

After an order is placed, the customer’s browser is redirected to https://app.paymento.io/gateway with the payment token for that order, where they complete the payment. No other customer data is included in the redirect.

📌 Data Received

Paymento sends payment status notifications to /wp-json/paymento/result on your store. Every notification is verified with an HMAC SHA256 signature using your Secret Key before it is processed.

🔗 Third-Party Policies

By using this plugin, your WooCommerce store communicates with Paymento API. You can review Paymento’s terms and policies here:

• Terms of Service: https://paymento.io/terms
• Privacy Policy: https://paymento.io/privacy

This ensures users are fully aware of the data being sent and why. 🚀

Troubleshooting

If you encounter any issues:

1. Enable Debug Log in the plugin settings.
2. Check the WooCommerce status report (WooCommerce > Status > Logs) for detailed error messages.
3. Ensure your API Key and Secret Key are correct.
4. Verify that your server can receive incoming webhooks from Paymento.

Support

For support, please open an issue on the GitHub repository or contact Paymento support for gateway-specific questions.

Contributing

Contributions to improve the plugin are welcome. Please fork the repository and submit a pull request with your changes.

License

This plugin is released under the GPLv2 or later license.