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:
| Method | When to Use It | Time to Verify |
|---|---|---|
| Plaid processor token (recommended) | The consumer has linked their bank account through Plaid Link | Immediately, when you create the payer |
| Microdeposits | No Plaid token is available for the consumer | 1 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
- The consumer selects a bank account through Plaid Link.
- Your application exchanges the Plaid public token for a Plaid processor token.
- You call the Create a Payer endpoint with
tokenType: "PLAID"and the processortoken. - Spinwheel validates the token and verifies that the consumer owns the bank account.
- 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 StartPlaid 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"
}
}Updated about 3 hours ago

