Get Started with Whalestack

Create a Whalestack account to unlock the power of cryptocurrency payments for your website.

Install the Whalestack Plugin

Download the Whalestack plugin or find it in the WordPress plugin search on your website. Activate the plugin after successful installation.

Configure API Keys

Retrieve your API keys, and input them into the Whalestack WordPress crypto payment plugin settings. Then, save your changes to enable cryptocurrency payments for your site.

Creating a New Button

To add a payment button, click on the Add payment button link in the Whalestack plugin sidebar menu. Provide a name and a JSON object for the new payment button.

To get started, simply copy the JSON example in the blue field and paste it into the white JSON object text area field. Then, customize the parameters according to your requirements. Refer to the API documentation for all possible parameters.

Customize the button (optional): Enter a custom button text and custom CSS style class for the button.

Once you save your changes, you will be redirected to the payment buttons overview page, where you can find the generated [shortcode] for that button.

Embedding the Button Anywhere

Copy the [shortcode] and embed it anywhere on your WordPress website. Simply add a shortcode block in the post/page editor and paste the shortcode into it.

If you want to use the shortcode in a widget, ensure that you use a Text widget. Widgets like Custom HTML do not render shortcodes.

For more details on using shortcodes, please refer to this guide.

Global Settings

On the settings page, you can manage your API credentials and configure global settings. These global settings allow you to override specific JSON parameters in the payment charge object:

• Return URL: Specifies where customers are redirected after a successful payment.
• Cancel URL: Specifies where customers go if they choose to cancel the checkout process.
• Webhook URL: A webhook URL on your server that listens for payment events.
• Settlement Currency: The currency in which you receive your payments. If left empty, it defaults to the payment currency.

With the Required Customer Info field, you define your tax compliance level and connect a payment to a customer.

• Minimal: Users must provide their first name, last name, and email. A customer is created in your Whalestack merchant account, and the payment is associated with it.
• Compliant: Users must provide their first name, last name, email, and address data. A customer is created in your Whalestack merchant account, and the payment is associated with it. This level also automatically generates a tax-compliant invoice for each purchase.

The following screenshot illustrates how the minimal and compliant options are displayed to users:

Logs

View all requests and responses to the Whalestack API on the logs page in your account. Useful for debugging purposes.

Translation

We recommend using the Poedit software for translation-related tasks. To translate the plugin into your language, follow these steps:

• Download and install Poedit software.
• Navigate to the plugins/whalestack/languages/ folder and copy the .pot file to your desktop for editing.
• Open the .pot file and create a new translation for your language.
• Translate all text strings.
• Save your translations as a .po file. Make sure to follow the correct naming convention, e.g., for the German language: whalestack-de_DE.po.
• Saving will automatically generate a whalestack-de_DE.mo file.
• Copy the .po and .mo files into the plugins/whalestack/languages/ folder.

To translate the "Custom Button Text" of the payment button, you have two options:

• If you leave it blank, the default Buy Now text is used and translated into any language for which you have a .po file. This is ideal for multilingual WordPress sites to ensure your button text matches the respective languages.
• If you enter custom button text, it will only display in the language you entered. This is suitable for single-language sites.