Cards
SorenPay issues cards through our card issuing partner. Every card has its own rules, checked on our servers on every payment.
In sandbox today
Cards run with test money. Without the card issuing partner connected, a
test card uses placeholder card details marked fixture: true, and you
try payments in the Try a test payment panel on the card's page.
Card types
| Type | Cost | How you get it |
|---|---|---|
| Virtual | Free | Created right away with POST /api/cards |
| Physical | $99 taken from your balance, or free with a $5,000 balance | Ordered with POST /api/physical-cards. Shipping updates aren't built yet |
Who a card is for
| Kind | Who |
|---|---|
| Agent | An AI agent or other software |
| Human | A teammate |
With the card issuing partner connected, every card is issued under an active
cardholder (POST /api/cardholders), and live cards also need your business
verification to be approved.
The rules on every card
Checked on our servers, in this order:
- State:
active,frozenorterminated - Per-payment limit (US cents)
- Merchant categories (4-digit codes; none set means all)
- Merchant names (matches part of the name, ignoring case; none set means all)
- Monthly limit (US cents)
- Balance available
Change limits, categories, merchants or state with PATCH /api/cards/{id}.
Terminating a card can't be undone.
Next
- Capabilities: what's built and what isn't
- API reference: cards
- Disputes + chargebacks