PayzCore Docs

OpenCart

OpenCart 3.x extension for USDT/USDC blockchain payment monitoring. Accept stablecoin payments in your OpenCart store with PayzCore webhook notifications.

OpenCart Integration

The PayzCore OpenCart extension adds USDT/USDC blockchain monitoring as a payment method in your OpenCart 3.x store.

How It Works

  1. Customer selects "Pay with USDT/USDC" at checkout.
  2. OpenCart creates the order and the extension calls the PayzCore API.
  3. Customer sees the wallet address and the exact amount to send.
  4. Customer sends stablecoins from their wallet.
  5. PayzCore detects the transfer on-chain and sends a webhook.
  6. Extension receives the webhook and updates the order status.

PayzCore monitors the blockchain for the transfer. The extension does not handle any funds — it only reads the PayzCore API and updates OpenCart order statuses.

Installation

  1. Download the latest release from GitHub
  2. Extract and upload to your OpenCart root directory (preserves folder structure)
  3. In OpenCart admin: Extensions > Extensions > Payments
  4. Find PayzCore (USDT/USDC) and click Install, then Edit

Configuration

SettingValueNotes
StatusEnabledActivate the payment method
API URLhttps://api.payzcore.comPayzCore API endpoint
API Keypk_live_...From your PayzCore project
Webhook Secretwhsec_...From your PayzCore project
Order Status (Pending)PendingStatus while waiting for payment
Order Status (Paid)ProcessingStatus after successful payment
Sort Order1Display order among payment methods

When you save the settings, the extension calls GET /api/v1/config to auto-detect available chains and tokens from your connected wallet. The chain and token dropdowns are populated automatically — no manual selection is needed.

Set your webhook URL in the PayzCore dashboard to:

https://yourstore.com/index.php?route=extension/payment/payzcore/webhook

Order Status Mapping

PayzCore EventOpenCart StatusNotes
payment.completedProcessingNormal successful payment
payment.overpaidProcessingOrder history note added
payment.partialPendingCustomer needs to send remaining
payment.expiredCancelledPayment window closed

Customer Experience

  1. At checkout, customer selects the PayzCore payment method
  2. After confirming the order, they see:
    • The wallet address to send funds to
    • The exact amount to send (in USDT/USDC)
    • The selected blockchain network
  3. Customer sends the exact amount from their wallet
  4. Once confirmed, the order automatically moves to "Processing"

Troubleshooting

Webhook not received

  • Verify the webhook URL in your PayzCore dashboard matches your OpenCart webhook endpoint
  • Ensure your server allows POST requests from external sources
  • Check for .htaccess or firewall rules blocking external POST requests
  • Review webhook delivery logs in PayzCore dashboard: Payments > [Payment] > Webhook Logs

Order not updating

  • Confirm the Webhook Secret matches between PayzCore dashboard and OpenCart settings
  • Check OpenCart error logs in System > Maintenance > Error Logs
  • Verify the extension is installed and enabled

Payment method not showing at checkout

  • Ensure the extension status is Enabled in payment settings
  • Check that all required fields (API Key, Webhook Secret) are filled in and that the config fetch succeeds
  • Verify the extension files are correctly uploaded to the OpenCart directory structure

On this page

OpenCart IntegrationHow It WorksInstallationConfigurationOrder Status MappingCustomer ExperienceTroubleshootingWebhook not receivedOrder not updatingPayment method not showing at checkout