Integrations / nopCommerce
CRYPTO PAYMENTS · NOPCOMMERCE

nopCommerce + BitPayPal

Connect nopCommerce to BitPayPal for platform-controlled crypto invoices, hosted checkout and verified payment events.

Create merchant accountDownload package

nopCommerce BitPayPal integration

Invoice flow

Create an invoice with a unique idempotency key, redirect the customer to hosted checkout and store the BitPayPal invoice ID alongside the platform order.

Payment verification

Use the server-side invoice status and verified webhook event. Never mark an order paid because a browser returned to your success URL.

Webhook security

Verify the HMAC signature, timestamp and event ID, then persist processed event IDs to prevent replay.

Test mode

Use the merchant Integration Test Center to send a signed simulated event. Test mode never broadcasts cryptocurrency or authorizes a real order fulfillment.

Integration model

This package contains platform-facing integration code for the target platform. Validate the exact target platform version and run the supplied test contract in staging before production activation.

Supported version
4.70+
Package type
plugin
Integration point
Plugins/Payments.BitPayPal
Capabilities
hosted_checkout, invoice_create, payment_info, invoice_cancel, refunds, service_discovery, signed_webhook, idempotency, test_mode

Detailed installation

  1. Confirm the target is 4.70+ and that the server meets the platform requirements.
  2. Create a dedicated BitPayPal API key with only the scopes required for invoice creation and webhook reconciliation.
  3. Copy the plugin into the Plugins directory, run the application/plugin migration, restart nopCommerce and configure the payment method in the admin panel.
  4. Connect the platform integration point: Plugins/Payments.BitPayPal.
  5. Configure BitPayPal base URL, API key, asset, wallet/invoice settings and the webhook secret in the platform administration area.
  6. Set the webhook URL to the endpoint provided by the package and enable HTTPS.
  7. Create a test invoice, verify the signed webhook, then enable the integration for live orders.
  8. For production, reconcile by invoice ID, immutable order ID, asset and amount; never trust a browser return URL as payment proof.

Self-installable BitPayPal package. Configure credentials in the target platform, run the included staging contract, then enable live checkout. No marketplace installation is required.

Recommended production flow

  1. Create a BitPayPal invoice from the platform order.
  2. Store the invoice ID and immutable order ID.
  3. Redirect the customer to the BitPayPal hosted checkout.
  4. Verify signed server-to-server events.
  5. Update the platform order idempotently after the configured payment state.
  6. Handle expiry, underpayment, overpayment and reorg-related events according to your business rules.