OasisPay Checkout for WooCommerce

By Oasispay

0+ active installationsVersion 0.2.0

Accept WooCommerce payments through OasisPay Checkout or Dynamic Bank Transfer.

Description

OasisPay Checkout for WooCommerce offers two independent payment choices: Hosted Checkout and Nomba-powered Dynamic Bank Transfer. Each order using bank transfer receives a temporary bank account through the existing OasisPay API. The order remains pending until OasisPay confirms payment.

It works with both the classic WooCommerce checkout shortcode and the WooCommerce Checkout Block.

Security features:

  • Server-side API calls only.
  • OasisPay secret keys are not sent to browsers.
  • Browser returns are verified through OasisPay before an order is marked paid.
  • Server-to-server webhooks are verified using X-OasisPay-Signature and X-OasisPay-Timestamp.
  • Duplicate webhooks are idempotent because orders are matched by stored OasisPay payment reference.
  • Logs are sanitized and do not include secret keys or webhook secrets.

External Services

This plugin connects to the OasisPay API to create hosted checkout sessions and Nomba dynamic accounts, verify payments, and receive payment status updates.

The OasisPay service is required for this plugin to function.

Data sent to OasisPay may include:

  • Merchant API credentials.
  • Order reference.
  • Order amount.
  • Currency.
  • Customer name.
  • Customer email address.
  • Customer phone number.
  • Transaction metadata.

Data is sent only when a customer initiates a payment, when payment verification is performed, or when OasisPay sends a payment status webhook to the merchant site.

OasisPay service: https://oasispayhq.com

Terms of Service: https://oasispayhq.com/legal/terms

Privacy Policy: https://oasispayhq.com/legal/privacy

Installation

  1. Upload the oasispay-checkout folder to /wp-content/plugins/.
  2. Activate “OasisPay Checkout for WooCommerce” from WordPress plugins.
  3. Go to WooCommerce > Settings > Payments > OasisPay Checkout.
  4. Select Test or Live for the shared API connection.
  5. Add the matching OasisPay secret key.
  6. Copy the displayed Webhook URL.
  7. In your OasisPay merchant dashboard, create a webhook endpoint with that URL and enable:
    • payment.success
    • payment.failed
  8. Paste the webhook secret generated by OasisPay into the plugin settings.
  9. Independently enable OasisPay Checkout, Dynamic Bank Transfer, or both under WooCommerce payment settings. Dynamic Bank Transfer requires Live mode, an NGN store, the live key and the webhook secret. Test mode does not create usable bank details.

FAQ

Does this version support Dynamic Bank Transfer?

Yes. Enable the separate Dynamic Bank Transfer method to create a one-time Nomba virtual account for each order. It does not use a reserved merchant funding account. The order stays pending until a signed webhook and OasisPay verification confirm payment.

Can a customer redirect mark an order as paid?

No. The return handler verifies the payment status with OasisPay before completing the WooCommerce order.

What webhook events should be enabled?

Enable payment.success and payment.failed. The plugin safely acknowledges transaction.created but does not use it to complete orders.

Changelog

0.2.0

  • Add a separately enabled Nomba Dynamic Bank Transfer payment choice for classic and block checkout.
  • Keep transfer orders pending until a signed webhook is verified against the OasisPay payment status.
  • Fail closed in test mode and when live credentials, webhook secret, or usable account details are missing.

0.1.6

  • Update – Bump WooCommerce tested-up-to header to 10.8.1 for QIT validation.

0.1.5

  • Update – Bump WordPress and WooCommerce tested-up-to headers for QIT validation.

0.1.4

  • Security – Restrict API Base URL to the official OasisPay HTTPS API host.
  • Security – Document signed webhook raw-body handling for marketplace scanners.
  • Update – Add complete WooCommerce Marketplace metadata and Checkout Blocks compatibility declaration.

0.1.3

  • Update checkout payment badge shown in WooCommerce checkout.

0.1.2

  • Fix WooCommerce Checkout Block compatibility on sites where the parent Blocks integration exposes protected settings.

0.1.1

  • Add WooCommerce Checkout Block support.
  • Add bundled OasisPay logo for gateway listings and checkout labels.

0.1.0

  • Initial Hosted Checkout gateway for WooCommerce.