WooCommerce Plugin¶

Accept credit and debit card payments on your WooCommerce store through Blackstone. The Blackstone Online Gateway plugin adds a fully integrated payment method to your checkout, handles 3D Secure authentication, supports surcharges and dual pricing, and lets you refund transactions directly from the WooCommerce order screen - no external portal required.

How it works¶

flowchart LR
  A["Customer<br/>checks out"] --> B["Blackstone<br/>gateway"]
  B --> C["3D Secure<br/>if enabled"]
  C --> D["Card charged<br/>by Blackstone"]
  D --> E["Order marked<br/>as Paid in WooCommerce"]

1. The customer selects Credit Card at checkout and enters their card details.
2. If 3D Secure is enabled, the customer is prompted to authenticate with their bank.
3. Blackstone charges the card and returns an authorization.
4. WooCommerce moves the order to Processing (or Completed for virtual orders) and stores the transaction reference on the order.

Before you begin¶

Install the plugin¶

1. Download the latest version¶

Download the plugin ZIP from the latest release. You can also pick a specific version from the version history at the bottom of this page.

2. Upload it to WordPress¶

In your WordPress admin, go to Plugins → Add New → Upload Plugin, choose the ZIP file, and click Install Now. When the upload finishes, click Activate Plugin.

Configure your credentials¶

Credentials are entered once by an administrator and stored in your WooCommerce settings.

1. Open the gateway settings¶

Go to WooCommerce → Settings → Payments and click Manage next to Blackstone Payment Gateway (or click the payment method name).

2. Enable the gateway and set the display¶

At the top of the settings screen:

• Tick Enable Blackstone payment gateway.
• Title - the name customers see at checkout (default: Credit Card).
• Description - the short text shown under the title at checkout (default: Pay securely with your credit or debit card.).

3. Enter your API credentials¶

Under API Credentials, fill in:

4. Choose the environment¶

Under Environment → Gateway Environment, pick one:

• Sandbox (Test Transactions) - no real charges are made. Use this while you're setting things up and testing the flow.
• Production (Live Transactions) - real cards, real money. Only switch to this once you've completed a successful sandbox test.

Click Save changes at the bottom of the screen.

Optional features¶

3D Secure¶

Under 3D Secure, tick Require 3D Secure authentication to enable 3DS. When active, cardholders are asked to confirm the transaction with their bank (usually via a code sent to their phone or through their banking app) before the payment goes through.

3D Secure uses the same environment as the gateway - sandbox 3DS with the sandbox gateway, production 3DS with production.

Surcharges and dual pricing¶

Under Fee Labels, you can customize how card-related fees appear to customers:

• Surcharge Label - the label for an extra fee added when paying by card (default: Card Processing Fee).
• Cash Discount Label - the label for the price difference between card and cash pricing (default: Card Price Difference).

The percentages themselves are configured on your Blackstone merchant account, not in WooCommerce. The plugin reads them from Blackstone and applies them automatically at checkout.

Debug logging¶

Under Debugging, tick Enable debug logging while troubleshooting. Logs are written to WooCommerce → Status → Logs and include API requests, responses, and 3DS trace data. Turn it off in normal production use to keep logs clean.

Take a payment¶

1. Customer checks out¶

The customer adds items to the cart, goes to Checkout, selects Credit Card (or whatever you set as the title), and enters their card details.

2. 3D Secure verification (if enabled)¶

If 3D Secure is on, a modal opens and the customer authenticates with their bank. On success, the modal closes and the order continues; on failure, the customer sees a message and can retry with a different card.

3. Order is created and paid¶

Once Blackstone authorizes the charge, WooCommerce creates the order and moves it to Processing (or Completed for orders with only virtual/downloadable products). An order note records the Blackstone service reference number for later lookup.

Pay-for-order links¶

You can also charge an existing order by sending the customer a pay-for-order link. From the order edit screen, click Customer payment page to copy the URL. The customer opens the link, enters their card, and pays - the same 3DS and surcharge rules apply.

Refunds¶

You can issue full or partial refunds directly from the order edit screen without leaving WordPress.

1. Open the order¶

Go to WooCommerce → Orders and open the order you want to refund.

2. Refund via Blackstone¶

Scroll to the Order actions area. Below the standard WooCommerce refund controls, you'll see a Refund via Blackstone button (or a similar labeled control) for each refundable line. Enter the amount and confirm.

The plugin sends the refund to Blackstone using the stored transaction reference, updates the order status to Refunded (full) or keeps it in its current status with the refunded amount deducted (partial), and adds an order note with the refund details.

Going live¶

Before switching to production:

• Complete at least one successful test transaction in Sandbox mode.
• Verify the customer receives the correct order confirmation email.
• Test at least one refund from the WooCommerce order screen.
• Confirm your site is served over HTTPS.
• If 3D Secure is required by your merchant account, test the challenge flow at least once.

When you're ready, go to WooCommerce → Settings → Payments → Blackstone Payment Gateway, switch Gateway Environment to Production (Live Transactions), save, and place a small real charge to confirm everything is wired correctly.

Troubleshooting¶

For anything not listed here, contact support@blackstonemerchant.com with your merchant ID, the plugin version, and a debug log covering the failing transaction.

Version history¶

Download latest¶

Download Latest

All versions¶