Quickstart

export OPENFI_API_KEY="sk_testnet_..."

curl https://api.openfi.co/v1/payments \
  -H "Authorization: Bearer $OPENFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2500,
    "currency": "USD",
    "source": { "type": "bank_account", "id": "src_123" },
    "destination": { "type": "wallet", "address": "0xabc123..." }
  }'

# 1. Create the mandate (the standing authorization)
curl https://api.openfi.co/v1/mandates \
  -H "Authorization: Bearer $OPENFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payer_account_id": "acc_123",
    "max_amount": 50,
    "currency": "USD",
    "interval": "daily",
    "purpose": "AI agent operational expenses"
  }'

# 2. Issue a session key scoped to that mandate
curl https://api.openfi.co/v1/session-keys \
  -H "Authorization: Bearer $OPENFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mandate_id": "man_123",
    "expires_in": 86400
  }'

# 3. Execute a pull against the session key
curl https://api.openfi.co/v1/debit-pulls \
  -H "Authorization: Bearer $OPENFI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session_key_id": "sk_123",
    "amount": 12.50
  }'