Verifying a Payer

Before a payer can initiate a payment-to-platform, Spinwheel needs to confirm that they own the bank account. There are two ways to do this:

MethodWhen to Use ItTime to Verify
Plaid processor token (recommended)The consumer has linked their bank account through Plaid LinkImmediately, when you create the payer
MicrodepositsNo Plaid token is available for the consumer1 to 3 business days

Verify with a Plaid Token (Recommended)

When a consumer has already connected and verified their bank account through Plaid Link,, Spinwheel can confirm ownership as soon as you create the payer. There's no waiting, and the payer can start ACH payments right away.

How It Works

  1. The consumer selects a bank account through Plaid Link.
  2. Your application exchanges the Plaid public token for a Plaid processor token.
  3. You call the Create a Payer endpoint with tokenType: "PLAID" and the processor token.
  4. Spinwheel validates the token and verifies that the consumer owns the bank account.
  5. The payer can initiate ACH payments immediately.

Example Request

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "paymentMethod": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "tokenType": "PLAID",
    "token": "processor-sandbox-123456789"
  }
}

Before You Start

Plaid token verification requires a couple of configuration items on your account before it will work end to end — including Tabapay enablement on your Plaid integration. Check with your Spinwheel contact to confirm you have what you need configured before rolling this out.

Verify with Microdeposits (Fallback Method)

If you don't have a Plaid token for a consumer, use micro-deposit verification instead. Two small deposits are sent to the consumer's bank account. The consumer then checks their bank statement and confirms the amounts. This usually takes 1–3 business days, and the payer can't initiate ACH payments until it's done.

To use this method, call the same Create a Payer endpoint and leave out tokenType and token:

Example Request

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "paymentMethod": {
    "routingNumber": "021000021",
    "accountNumber": "123456789"
  }
}

Did this page help you?