TABLE OF CONTENTS


The Test Mode in Blockonomics lets you simulate a BTC/USDT payment without using real money. It’s a safe way to make sure your payment setup works correctly before going live. With just a few clicks, you can test your store, verify callbacks, and confirm that everything is connected and receiving payments properly.

  • For USDT Test Mode on WooCommerce, ensure you are using plugin version 3.9.1 or later
  • BTC Test Mode works on all plugin versions, as it is fully handled server-side
  • Test addresses are simulated. Do not send real BTC/USDT to these addresses, as funds sent will be lost and cannot be recovered.


What you will need before you start?

Before using the Test Mode, make sure you have:

  • A Blockonomics account
  • Your store added in Blockonomics. Click here to know how to add Store in Blockonomics.
  • A wallet configured(BTC/USDT) in your dashboard. Click here to know how to add Wallets in Blockonomics.
  • Once you have added the store, enable Testmode as shown below and click on Update Store.

No real BTC/USDT is required, this test uses a simulated payment, so there is zero risk and no actual funds are used.

How to set up a BTC test payment?

Follow the steps below to simulate a Bitcoin payment using the Blockonomics Test Mode.

  1. Ensure that Test Mode is enabled for your store in Blockonomics. This allows you to simulate payments without using real Bitcoin.
  2. Go to your store and place a test order. On your website, add any product to the cart and proceed to BTC checkout, just like a normal customer would.
  3. Generate the payment details, when you reach the Bitcoin payment page, you will see:
    • A Bitcoin Test Address
    • The exact BTC amount required for the order
      Keep this page open, you will use these details in the Test Bench.
  4. Open the Blockonomics Test Bench and locate the Test Bitcoin Wallet section.
  5. Verify the Test Address in the Test Bench matches the Bitcoin address shown on your checkout page.
  6. Copy the BTC amount displayed on your website’s checkout page.
  7. Paste it into the BTC Amount field in the Test Bench.
  8. Click Send to simulate the transaction.




How to set up a USDT test payment?

Follow the steps below to simulate a USDT payment using the Blockonomics Test Mode.
Note: USDT Test Mode on WooCommerce requires Blockonomics plugin v3.9.1 or later. If you are using an older version, Test Mode may not work as expected.

  1. Ensure that Test Mode is enabled for your store in Blockonomics. This allows you to simulate payments without using real funds.
  2. Place a Test Order on Your Website: Visit your website as a customer would and add any product to the cart.
    Proceed to checkout and select USDT as the payment method.
  3. Connect Your Wallet:
    • On the payment page, click Connect Wallet.
    • A wallet popup will appear showing your Test Ethereum Wallet.
    • Click Connect to link your wallet to the checkout.
  4. Initiate the Payment
    • Once connected, you will see your test wallet address and network details.
    • Click the Pay [USDT Amount] button to initiate the transaction.
    • A confirmation popup will appear in your wallet.
    • Review the transaction details and click Confirm.
  5. Order Confirmation: After confirming the payment, you will be redirected to the Order Received page.


How to Use Test Mode to Simulate a Payment for Your Payment Button Order?

Follow the steps below to simulate a payment using a Blockonomics payment button in Test Mode.

  1. Navigate to Buttons & Links:
    • Log in to your Blockonomics account.
    • Go to the Buttons & Links section from the dashboard.
  2. Enable Test Mode
    • Under Payment method, locate the Testmode option.
    • Ensure that the required payment methods(BTC/USDT) are enabled:
    • Toggle Testmode ON to enable simulated transactions.
  3. Create a Product and Generate a Payment Button
    • Navigate to the Products tab under Buttons & Links.
    • Click on Add a Product (or use an existing product).
    • Fill in the required details, Once all details are entered, click Save Changes.
    • To generate the payment button, click on Generate Button.
  4. Generate and Test the Payment Button
    • Click on Generate Button to create your payment button.
    • Once generated, you will see a Button Preview section.
    • Click on the Pay with Crypto button under the preview to initiate a test transaction.
  5. Complete the Test Payment
    • After clicking Pay with Crypto, a pop-up will appear prompting you to:
      • Enter customer details (Email, Name, etc.)
      • Select the payment method (BTC or USDT)
    • Click Pay to proceed.


  6. For BTC Payments
    • A payment window will display:
      • A Test Bitcoin address
      • The exact BTC amount to be sent
    • Keep this window open, as you will need these details.
    • Open Log/Test Bench in a new Blockonomics tab.
    • Verify that the “Pay to” address matches the address shown in the payment window.
    • Enter the BTC amount exactly as displayed.
    • Click Send to simulate the transaction.
  7. For USDT Payments:
    • Connect your test wallet when prompted.
    • Click Pay and confirm the transaction in the wallet popup.
  8. Verify Payment Confirmation:
    • Once the test payment is completed.
    • A Payment Received confirmation message will be displayed on the payment button interface.
    • The transaction will also be reflected in the Test Bench logs.


How to check the results and callback logs?

Blockonomics simulates real payment flows in Test Mode, including transaction detection and confirmation stages.
This applies to both BTC and USDT, allowing you to test how your system handles different payment statuses.


BTC Test Mode

  • Status = 0 (Payment detected) → Callback sent instantly
  • Status = 1 (Partial/1 confirmation) → Callback sent after ~5 minutes
  • Status = 2 (Fully confirmed) → Callback sent after ~10 minutes

USDT Test Mode

  • Callback is sent within ~1 minute

If you do not receive a callback immediately, please wait for the expected duration before retrying.
This delay is intentional and simulates real network confirmations.

Here’s how to verify the results:

  1. Go to your Blockonomics Dashboard → Logs / Test Bench. 
     You’ll see a list of test transactions with their current status.
  2. Confirm successful callback (Status Code 200)
    A successful callback will show a response ending with “200” this means your store received the callback correctly.
  3. Match Bitcoin address and amount
    Ensure the Bitcoin address and amount in the log match what you entered in the Test Bench.
  4. In WordPress → WooCommerce → Orders, locate your test order.
    The order status will update according to the payment status

  5. If you are not receiving a 200 status code, or callbacks are failing, please refer to our Callback Troubleshooting Guide for detailed steps to diagnose and resolve the issue.