Skip to main content

Partner documentation

Card API

Issue and manage payment cards for your end clients through one API and one credential. The service operates the card program and the issuer relationship; the issuer holds the collateral on-chain and you control the funding wallet. The service orchestrates and observes — it never holds or moves your funds.

Get startedAPI Reference
Sandbox
https://api.sbx.oxen.finance/v1/card
Production
provided at go-live

Integration Guide

Start here. Authentication and key lifecycle, the request envelope, idempotency on the money path, how to classify and retry an error, webhooks and signature verification, and a sandbox checklist to work through before go-live.

API Contract

The published shapes: resource model and id prefixes, every request and response body, the full error-code catalog with retry verdicts, and the completeness ledger tracking what is still open. Sections marked ✅ are verified end to end on sandbox.

API Reference

Endpoint-by-endpoint reference generated from the OpenAPI document that the running service serves — so it cannot drift from the API. Parameters, schemas, status codes and copy-ready request samples.

What the API covers

  • Onboard end clients through KYB
  • Verify cardholders through hosted KYC
  • Issue virtual and physical cards
  • Freeze, limit, replace and cancel
  • Reveal PAN, CVV and PIN through an encrypted session
  • Read funding and spending power
  • Query transactions
  • Manage disputes and evidence
  • Receive signed webhooks