API Reference
Start typing to search…

Testing

Testing BTC Integrations

Using the Test Bench from Blockonomics, you can simulate transactions to your bitcoin address. These test payments are generated and sent by Blockonomics' server, mimicking real API notifications. However, they are not broadcasted to the actual bitcoin network, so no real funds are involved—it's purely for testing purposes.

Steps to Use Test Bench

  • Access the Test Bench: Go to the Test Bench page.
  • Select Store: Select the store you want the callback to be sent to.
  • Enter Bitcoin Address: Provide the bitcoin address where test payments should be "sent." Make sure this address is generated via Create or Get Payment Address
  • Choose Amount: Specify an amount for the test payment.
  • Initiate Test Payment: Click to trigger a simulated transaction.
  • Select Payment Status: Select between unconfirmed, partially confirmed, and confirmed.
  • Observe Callback Logs: The Test Bench will send a callback notification following Blockonomics' API format.
  • Verify Webhooks & Responses: Check how your server handles these incoming test payment signals.
  • Debug & Optimize: Use the test results to troubleshoot any errors and refine your integration.

Testing USDT Integrations

Sepolia is a widely used Ethereum testnet, ideal for testing USDT (Tether) integrations before deploying on the main Ethereum network. Here’s how you can set up and test USDT transactions on Sepolia.

Requirements:

  • Install the Metamask browser extension.
  • You can activate Sepolia network in Metamask using these instructions.
  • You can then add Sepolia USDT token to Metamask using the 0x419Fe9f14Ff3aA22e46ff1d03a73EdF3b70A62ED contract address.
  • You can add Sepolia ETH to your wallet from Google's Ethereum Sepolia Faucet .
    • Sepolia ETH is needed for gas fees when testing USDT transactions.
  • You can get Sepolia USDT for testing from OKX .

Conducting the Tests

An easy way of testing USDT Payments is to use our Web3 USDT Component , with testnet set to 1. After the test payment is done, you will be redirected to the redirect_url with the transaction hash (txhash) appended to the URL.

Then monitor the txhash using the Monitor USDT Transaction endpoint. Finally Blockonomics' server will send your server a Callback Notification when the transaction is confirmed.