Prerequisites
Before you begin, ensure you have:- A Straddle account with API access
- A Quiltt account with processor token capabilities
- Quiltt Connector configured with
ACCOUNT_NUMBERS
andACCOUNT_BALANCE_REFRESHES
features
For a complete integration guide including Quiltt Connector setup, see our detailed Quiltt integration guide.
Quick start
Follow these steps to create a paykey from a Quiltt processor token.Step 1: Obtain a Quiltt processor token
After your user connects their bank account through Quiltt Connector, create a processor token:Step 2: Create a paykey via Bridge API
Use the processor token to create a paykey:Step 3: Handle the response
A successful response returns the paykey and associated bank data:Store the
paykey
securely for future transactions. Use it to create charges and Straddle will verify the account balance before processing.Implementation flow
1
Connect bank account
User connects their bank account via Quiltt Connector
2
Fetch account details
Fetch account details using Quiltt’s GraphQL API
3
Create processor token
Create processor token for selected account
4
Bridge to Straddle
Bridge processor token to create Straddle paykey
5
Store paykey
Store paykey for payment processing
Troubleshooting
Common issues and their solutions:Issue | Solution |
---|---|
Invalid processor token | Ensure processor: "STRADDLE" and issuer: "QUILTT" |
Authentication errors | Verify your Quiltt API key and Straddle API key |
Missing features | Enable ACCOUNT_NUMBERS in Quiltt Connector |
Connection not active | Wait for connection status to be active |