Skip to main content

​
Overview

The Tender WooCommerce plugin is a WordPress payment gateway that embeds the Tender JavaScript/React SDK directly into your WooCommerce checkout flow. Instead of custom HTML forms, the plugin uses the @tender-cash/agent-sdk-react package to render the Tender payment experience, including support for:
  • Crypto payments in your WooCommerce store
  • Completed, partial, and overpayment handling
  • Test and live environments
  • WooCommerce Blocks checkout compatibility
  • Automatic WooCommerce order status updates
You can install the plugin from the provided ZIP file:

​
Installation

Follow these steps to install the Tender WooCommerce plugin:
  1. Download the plugin ZIP: woo-tender-sdk.zip
  2. In your WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Upload the ZIP file and click Install Now
  4. Click Activate to enable the plugin
  5. Go to WooCommerce → Settings → Payments
  6. Enable “Tender SDK Payment” and click Manage to configure it
Alternatively, you can upload it manually:
  1. Extract the ZIP
  2. Upload the woocommerce-payment-sdk-gateway folder to /wp-content/plugins/
  3. Activate the plugin in Plugins

​
Configuration

In WooCommerce → Settings → Payments → Tender SDK Payment, configure the gateway with your Tender credentials.

​
Required settings

  • Access ID: Your Tender merchant Access ID (from the Tender dashboard)
  • Access Secret: Your Tender merchant Access Secret
  • Agent ID: Your Tender Agent ID
  • Environment: Test (staging) or Live (production)

​
Optional settings

  • Title: Name shown to customers at checkout (default: “Pay with Crypto”)
  • Description: Description shown on the checkout page
Make sure the credentials you use match the selected environment (test vs live).

​
How It Works

The WooCommerce gateway wraps the Tender React SDK and handles order status updates for you.
  1. Customer selects Tender SDK Payment at checkout
  2. After placing the order, they are redirected to the Tender payment page
  3. The Tender React SDK loads and renders the payment UI
  4. Customer chooses a cryptocurrency and completes payment
  5. The SDK sends the payment status back to WordPress via secure AJAX
  6. WooCommerce order status is updated automatically:
    • Completed – Order marked as paid
    • Overpayment – Order completed with a note about the excess amount
    • Partial payment – Order placed on hold pending full payment
    • Error / Cancelled – Customer is redirected back to checkout

​
SDK Integration Details

Under the hood, the plugin uses the Tender Agent SDK React library:
  • Package: @tender-cash/agent-sdk-react
  • Load method: ES module from CDN (unpkg.com)
Example of the SDK props used by the plugin: 
<TenderAgentSdk
  accessId="YOUR_ACCESS_ID"
  fiatCurrency="USD"
  env="test"           // or "live"
  amount={150.00}
  referenceId="order-123-timestamp"
  paymentExpirySeconds={1800}
  theme="light"
  onEventResponse={handlePaymentCallback}
/>
The onEventResponse callback is responsible for sending the payment result back to WordPress, which then updates the WooCommerce order. For a deeper dive into the SDK itself, see the JavaScript SDK docs at /sdk/javascript.

​
File Structure (Plugin)

The main plugin files are organized as follows: 
woocommerce-payment-sdk-gateway/
├── woocommerce-tender-sdk-gateway.php        # Main plugin bootstrap file
├── class-woocommerce-tender-sdk-gateway.php  # WooCommerce gateway implementation
├── templates/
│   └── tender-sdk-payment.php                # Payment page template that mounts the SDK
├── blocks/
│   ├── class-tender-sdk-payment-block.php    # WooCommerce Blocks integration
│   └── build/
│       ├── index.js                          # Block script
│       └── index.asset.php                   # Asset dependencies
├── languages/                                # Translation files
└── README.md                                 # Plugin README
Key WordPress/WooCommerce integration points:
  • woocommerce_payment_gateways – registers the gateway
  • woocommerce_blocks_payment_method_type_registration – registers the checkout block
  • wp_ajax_tender_sdk_update_order_status – handles payment status updates

​
Requirements

To use the plugin in production, you need:
  • WordPress 5.0 or higher
  • WooCommerce 3.0 or higher
  • PHP 7.4 or higher
  • A modern browser with JavaScript enabled
  • Valid Tender Access ID, Access Secret, and Agent ID

​
Security Considerations

The WooCommerce plugin follows WordPress security best practices:
  • All AJAX requests use WordPress nonces
  • Tender access credentials are stored securely in WordPress options
  • Order IDs and payment data are validated before processing
  • Payment details are sanitized before being stored
For additional security recommendations, see the Best Practices section in the JavaScript SDK docs.

​
Support & Next Steps

If you encounter issues:
  • WooCommerce / WordPress integration: Contact your internal development team
  • Tender SDK behavior: Refer to the JavaScript SDK docs or Tender support
You can continue exploring:

JavaScript SDK

Learn more about the underlying Tender React SDK.

API Reference

Explore the full Tender API.