Skip to main content

Checkout Journey

Let's look at a typical customer journey for a Hokodo payment. There are 6 stages to the process, and each is described below in a separate section.

A timeline of the checkout journey showing each step as per the headings below.

For a live example, see our Demo Merchant Store

Note

This is just one example - you can fit the flow around your site's design.

You can perform the Hokodo parts of the journey at different stages of the user journey, for example you could run the company search after the user clicks "checkout".

See Your Design Decisions for a list of common design choices made during an API Integration.

1. Search for company

The customer must identify the company they work for, in order to verify their eligibility to payment terms. Hokodo provides an SDK element for this, which you can use in your user sign-up workflow, or alternatively during checkout.

When the user enters their company name or registration number, Hokodo searches for this company in our database and presents a list of matches. The customer selects the appropriate match.

The Company Search element with 'Dyson' entered and a list of matches
Note

Company search can be skipped for returning customers. If your customer is registered on your site, you can store the customer's Hokodo User ID in your database, and supply this at checkout time.

See our Company Search In-Depth section for additional information on how it works.

2. Order submission

Having registered, the user shops around on your site and fills their basket with goods.

When they check out, you send the details of their basket to the Hokodo API. Our system checks the payment terms that this user is eligible for on this basket of goods.

The Company Search box with 'Dyson' entered and a list of matches

3. Display Hokodo option at checkout

Some Merchants display Hokodo alongside other payment options on the checkout page, in the event that payment terms have been offered for the order.

Many merchants have chosen Hokodo to provide their Pay Now payments as well as the Pay Later ones. This means all your payments can be handled with little or no extra integration effort. You can read more about this in In Depth Knowledge.

A store's payment page with Hokodo as one of the payment options

Hokodo's SDK provides a checkout UI element, and you should display this as part of your checkout or integrate it however best meets your needs.

4. Select a payment plan

If a range of payment plan options are available, the customer selects one in the Hokodo SDK checkout.

The Hokodo checkout with Pay in 60 Days and Pay in 30 Days options displayed. The mouse cursor is on the Pay In 60 Days.

5. Take payment details and confirm order

Next, the customer selects a settlement method (e.g. credit card, direct debit, bank transfer...). This happen within the SDK checkout element.

The Hokodo checkout with Pay in 60 Days and Pay in 30 Days options displayed. The mouse cursor is on the Pay In 60 Days.

After entering the payment details, the customer clicks the "confirm" button. The SDK sends a request to Hokodo's API to make the final order confirmation.

A modal with a payment timeline and some payment methods displayed.

The checkout process is now complete and the customer receives an email confirming their payment terms.

An email displaying some example Buy Now Pay Later payment terms.

5. Post-sale: capture the payment

When the goods are shipped or services completed, your back-office system makes a Capture API call to inform Hokodo what value of the order has shipped. This is the trigger for us to pay out funds to you for the captured amount. On the due date of the Payment Plan we will charge the buyer the sum of all Captures.

There are also API endpoints to:

  • register Refunds (to ensure we collect the correct amount from the buyer), and
  • Void authorisation (the credit limit reserved in relation to the order) that is no longer needed.