WooCommerce
WooCommerce
This documentation explains the process of integrating WooCommerce with Bitstream using the Bitstream plugin. By integrating with Bitstream, you can enable your store to accept various crypto payments.
1. Installing the Bitstream Plugin
In your WordPress dashboard, Choose
Plugins > Add New
.Search for "Bitstream Payment Gateway for WooCommerce" and select the official plugin from Bitstream.
Click
Install Now
.Once installed, click
Activate
to use the plugin.
2. Creating a Bitstream Account
If you haven't already, sign up for a Bitstream account.
Follow the onboarding process:
Add your business details.
Upload your company's logo and brand colors.
Configure wallet addresses for supported cryptocurrencies: Ethereum, Polygon, Solana, and BNB chain.
3. Linking to Bitstream and Configuring the Plugin
In the WordPress admin area, navigate to
WooCommerce > Settings > Payments
.Locate "Bitstream" in the list of available payment gateways.
Click on the
Manage
button alongside Bitstream.This will direct you to the plugin settings page for further configurations.
4. Adding the API Key
In your Bitstream dashboard, navigate to the
Developer > API keys
section.Click on "Generate API Key" to produce a unique key that will link your WooCommerce store to your Bitstream account.
Copy the generated API key.
Return to your WordPress plugin settings and paste the API key into the designated field.
5. Setting Up Webhooks
In Bitstream, navigate to the
**Developer > Webhooks**
Under webhook configurations or similar, select
Add endpoint
, and insert the URL provided in your WooCommerce plugin settings page.Ensure you copy and input any shared secret or additional authentication details as required in the plugin settings to ensure secure communication between Bitstream and your WooCommerce store.
Testing Integration with Test Mode
Before fully integrating Bitstream crypto payments into your WooCommerce store, utilizing the Test Mode is recommended to ensure smooth and accurate transactions.
Steps to Enable Test Mode:
Important Note: Ensure to use the Test Secret Key from dashboard.bitstream.dev for activating Test Mode. This specialized test mode not only ensures a secure and isolated environment for your test transactions but also allows you to view and verify all test payments distinctly from your live mode operations, maintaining a clean and safe separation.
Access WooCommerce Dashboard:
Navigate to
Payments > Settings
.
Activate Copperx Test Mode:
Find Bitstreamin the available payment gateways list.
Click on the
Manage
button to access its settings.Activate the 'Test Mode' option from the settings.
Retrieve Test Secret Key from Bitstream:
Navigate to
Developer > Generate Key
within your Bitstream dev dashboard and copy the 'Test Secret Key'.Return to the WooCommerce Bitstream settings and paste the key into the designated field.
Note: Always obtain the Test Secret Key from dashboard.bitstream.dev to ensure secure and accurate testing.
Perform Test Transactions:
Using the Bitstream faucet, acquire test tokens (e.g., USDC).
Initiate test transactions in your WooCommerce store using these tokens.
Verify Transactions:
After conducting test transactions, confirm that the funds reflect correctly in your test wallet.
Note: Always ensure you switch off 'Test Mode' and use the live API key when you're ready to accept real crypto payments.
Further Resources:
For any queries or assistance, the Bitstream support team is available to guide you every step of the way.
Last updated