SETUP GUIDE

CoinVoyage for WordPress

Add PayKit and SwapKit to WordPress pages with shortcodes.

Requirements

Your site needs WordPress 6.5+ and PHP 8.1+. A CoinVoyage public API key connects the widgets to your account. Standalone widgets do not require WooCommerce.

Get your CoinVoyage API key

Follow the API key setup guide to create your public API key.

PayKit supports crypto and eligible card payments. SwapKit is for token swaps.

Install the plugin

Download the ZIP. In WordPress, go to Plugins → Add New → Upload Plugin, choose the ZIP, then select Install Now and Activate.

Download WordPress widgets

Add your public API key

Open Settings → CoinVoyage. Enter your Public API key and save your settings.

If needed, add a WalletConnect project ID for your wallet setup. Standalone widgets use the public API key.

Place a widget on your page

Add a Shortcode block to your page. Use this for SwapKit:

Copy and paste

[coinvoyage_swap mode="dark"]

Or show PayKit for an existing order:

Copy and paste

[coinvoyage_pay order_id="YOUR_EXISTING_ORDER_ID"]

Customize the payment button with button_text. This also works with deposit shortcodes; leaving it blank keeps “Pay”.

Copy and paste

[coinvoyage_pay order_id="YOUR_EXISTING_ORDER_ID" button_text="Pay now"]

Replace the order ID. For store purchases, follow the WooCommerce guide to create an order for every checkout.

Accept a direct deposit instead

For a standalone deposit, set the chain, amount, and recipient:

Copy and paste

[coinvoyage_pay chain="1" amount="0.01" address="YOUR_RECIPIENT_ADDRESS"]

This is a deposit widget. It does not automatically verify a product purchase.

Customize widget appearance

Open Settings, then CoinVoyage for separate PayKit and SwapKit appearance settings. Set colors and radius, or enter Advanced theme JSON using the SDK properties. Leave fields empty to keep the defaults.

Override settings for one shortcode:

Copy and paste

[coinvoyage_swap accent="#d6296f" accent_hover="#b8225f" accent_text="#ffffff" radius="16px"]

The theme attribute accepts a JSON object. Advanced values override matching basic controls. Custom colors apply to both light and dark modes; load custom fonts on your site.

Copy and paste

[coinvoyage_swap theme='{"surface":"#ffffff","text":"#111827"}']

Test your setup

Preview the published page and test the wallets your customers use, including mobile. Make sure any WalletConnect configuration includes your site's origin.

Local integration checks pass; live provider payment and wallet verification are still pending.