Skip to main content

Configure

Learn how to configure and enable the Dojo for WooCommerce plugin.

After you have enabled the Dojo checkout method, do the following to begin setting up the plugin in your WooCommerce ecosystem:

  1. In the WooCommerce plugin, go to Settings > Payments.

  2. Under Payment Methods, click Finish set up in the Dojo checkout method.

    Configure

This takes you to Dojo checkout settings where you can configure the plugin.

How to configure the plugin​

To configure the Dojo for WooCommerce plugin, do the following:

  1. Create an API key.
  2. Use your API key.
  3. Add your webhook endpoint.
  4. Use your webhook endpoint.
  5. Disable WooCommerce Blocks​.

Step 1: Create an API key​

After installing the plugin, you need to create an API key from the developer portal.

Step 2: Use your API key​

  1. Copy the API key that you created.
  2. In the WooCommerce plugin page, go to Settings > Payments.
  3. In the Dojo checkout method, click Manage. This takes you to the Payments > Dojo checkout page.
  4. Under Gateway settings, in the Secret API key field, paste the API key.
  5. Click the Save changes button.
note

Ensure that you use the production API key.

Step 3: Add a webhook endpoint​

  1. In the Developer portal, go to Webhooks and click the Add endpoint button.
  2. Enter the endpoint URL.
note

This is your WordPress public URL followed by /?wc-api=wc_dojo. For example, https://yoursite.com/?wc-api=wc_dojo.

  1. Click Select events under Select Dojo events to listen to.
  2. Select Status update event. This displays the payment intent status.
note

You must select only Status update event. The rest of the events aren't needed.

  1. Click the Add events button.
  2. Click the Add endpoint button.

Webhook endpoint

Step 4: Use your webhook endpoint​

  1. In the webhooks page of the Developer portal, click the key under Secret value of your URL. This copies the secret value key to your clipboard.

  2. In the WooCommerce plugin page, go to Settings > Payments > Dojo checkout.

  3. Under Webhook settings, in the Webhook secret field, paste the key you copied.

    Webhook secret

  4. Click the Save changes button.

You are now all set to accept payments using Dojo checkout for your ecommerce transactions.

Step 5: Disable WooCommerce Blocks​​

Following the introduction of WooCommerce 8.4.0, the Blocks feature is now a default setting in new setups. It's important to note that the Dojo for WooCommerce plugin is not compatible with WooCommerce Blocks. For those who have updated to WooCommerce 8.4.0, it's essential to deactivate this feature to ensure the gateway plugin functions correctly.

To deactivate WooCommerce Blocks and revert to the traditional checkout interface, please follow these instructions:

  1. Access your WordPress admin panel.
  2. Go to Pages, then edit the Checkout page.
  3. In the Payment options area, find and select the block.
  4. In the panel on the right, go to the Block tab.
  5. Press the button to Switch to classic checkout and then save your modifications.

Alt text

Last updated on