Troubleshooting
Find your symptom, then walk through the checks in order. The first one that fails is your cause.
Something not working? Find what you're seeing below. Every guide starts with why it happens in plain words, then a short checklist you answer one question at a time, with how to check each thing and how to fix it.
Or press Ask (bottom right) and describe the problem in your own words, like "why won't my card payments work?".
| What you're seeing | Guide |
|---|---|
| Buyers only see crypto, card checkout fails, or your key says card isn’t allowed. | Card payments not working |
| The buyer says they paid, but the order isn’t there or you haven’t been paid. | Crypto payment not showing |
| Events don’t arrive, arrive twice, or your signature check rejects them. | Webhooks failing |
| Your agent gets a 402 it can’t satisfy, or its payment is rejected. | An AI agent can’t pay |
| Your AI assistant can look things up but won’t send, pay, swap or trade. | MCP money actions refused |
| Your server gets 401, 403, 404 or 429 from the merchant API. | API errors (401, 403, 429) |
Card vs. crypto
Crypto (USDC) checkout works for every Swop account immediately and is never gated on identity checks. Only card payments need merchant verification.