Bill Pay

Get started with bill pay

Before getting started

This guide will assume you've already created and authenticated a user. If you haven't done that then please first read our User Connect guide.


There are a number of steps that need to be carried out in order to make a bill payment. At a high level, these are:

  1. Create a partner payer
  2. Verify that partner payer
  3. Fund your account
  4. Create a user payer
  5. Make a payment request

Follow along with the steps below to help you through the process or get started with our Payments API Reference.

Creating and verifying a partner payer

To initiate a bill payment on the Spinwheel platform, the first step is to create a partner payer. By doing so, an entity will be created that can be utilized to finance all payments. You have the freedom to add numerous partner payers to your organization.

Please note that there is a verification process necessary to finalize the creation of a partner payer. This involves a micro-deposit flow, which requires you to verify two recent bank account transactions and send an API call to confirm these transactions. This step is crucial in ensuring that the correct bank account has been connected.

Funding your account

After successfully creating your partner payer, the next step is to fund your account by making a payment to platform. By doing so, you can ensure that there are sufficient funds available in your account to cover any payments that need to be made.

We will emit a PLATFORM_PAYMENT_STATUS webhook to notify you of the payment status after this step.

Creating a user payer

If you have successfully funded your account then it's time to create a user payer. Once this has been completed, you can create one-time or recurring payment requests on behalf of that user.

Making a payment

The final step is to create a payment request. Simply call the linked endpoint and we will emit a USER_PAYMENT_STATUS webhook to update you on the payment's status.

To learn more about our debt APIs and 1-click solutions, visit