Hokodo

Hokodo is a B2B payments platform that lets you offer Buy Now, Pay Later trade payment terms to your customers. Once integrated, customers can opt to pay in instalments as well as choose their preferred payment methods such as Pay on Invoice or Direct Debit. Learn more about Hokodo

The Hokodo integration for SparkLayer is available for all Shopify merchants and enables an additional payment method in the SparkLayer Quick Order Interface that lets customers choose from a range of special B2B payment terms. The integration works by first asking the customer to search for their Company, validating their Company details, and then determining if payment terms can be offered. If successful, the customer can choose from a variety of instalment options and then complete the checkout process as normal.

Once in the checkout, the customers' order will be processed with a 'zero value' total and payment is then captured via a post-purchase confirmation screen (powered by Hokodo) that asks them to confirm their payment plan and choose their payment method.

Once done, the order is complete and is then processed just like any other order on your website.

Once your Hokodo account has been approved, you're ready to activate it on SparkLayer! Within the SparkLayer Dashboard, go to the Configuration section, click Integrations, and then click the Partners tab.

Under Payment providers, click the toggle on the right to activate the Hokodo integration.

You'll then be prompted to enter in the API Key supplied by Hokodo. If you don't have one already, please contact Hokodo directly. If you're testing Hokodo using their Sandbox Environment, you can optionally activate this too.

Once you've added your API Key, the Hokodo integration is now activated. If you need to deactivate the integration or update your API Key, you can do so by clicking the toggle or the Modify button.

Shopify checkout

When the Hokodo integration for SparkLayer is activated, any customer that logs into your website will then see Hokodo as a payment option in the SparkLayer Quick Order Interface.

Within Shopify, it's necessary to adapt the checkout to enable the post-purchase Hokodo confirmation screen to allow customers to successfully complete their order.

To configure this, the following snippet must exist within the theme html provided on all pages.

Shopify Plus: Shopify Flow

Shopify Plus merchants also get access to a feature called Shopify Flow that lets you apply actions based on certain rules (see our guide here). For customers paying via Hokodo, it's possible to add tags to an order that allow easier filtering and reporting within the Shopify admin.Within Shopify Flow, you can configure the work flow based on 'Custom Attributes' that get added to any order placed via Hokodo. In the screenshot below, the flow is mapped by using a custom attribute key of sparkPaymentType and a custom attribute value of hokodoPayment.

Once you've configured this criteria, you can then apply actions such as tagging an order, sending an email, or any other action Shopify Flow supports.

Custom URLS

When the Hokodo widget is loaded, there are a number of links that allow customers to learn more about the service. These will go to predefined URLs so it's necessary to create redirects within Shopify to ensure they direct customers to the correct page on your website.

Within Shopify, go to Online Store, Navigation and click View URL redirects. You'll need to set up redirects for the following:

When a customer places an order using Hokodo as a payment method, it will funnel through to your Orders admin just like any other. If you're using Shopify, you'll see extra data included within the 'Additional Details' section when viewing an order. This data can be sent through to your backend system and allow you to see specific Hokodo information on a per-order basis.

If you're using Shopify Plus, you can customise orders with tags and order notes using Shopify Flow.

If your backend system (e.g. ERP, CRM) already integrates with SparkLayer, you may need to make some small adjustments to ensure Hokodo-related data is passed through correctly. Please contact us and we'll be happy to advice.

Please note the following: