Payment Flows

Aura credits can be purchased two ways: credit card via Stripe or cryptocurrency via Solana. Both flows are available through the API and via Claude with MCP.

Credit Card (Stripe)

Steps

1. List available plans

GET /api/v1/payments/credit_plans

Returns a list of plans. Note the id of the plan you want to purchase.

2. Create a Stripe checkout session

POST /api/v1/payments/credit_card

{
  "credit_plan_id": 11,
  "success_url": "https://your-app.com/payment/success",
  "cancel_url": "https://your-app.com/payment/cancel"
}

Returns:

{
  "payment_link": "https://checkout.stripe.com/..."
}

3. Complete payment in browser

Open the payment_link URL in a browser. Stripe handles card entry, 3DS verification, and the redirect to success_url or cancel_url.

Crypto (Solana)

Supported tokens: USDC and USDT on Solana.

Steps

1. List available plans

GET /api/v1/payments/credit_plans

Note the id of the plan you want.

2. Get the token mint address

GET /api/v1/payments/supported_tokens

Returns:

[
  {
    "symbol": "USDC",
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "recipient": "HYrGnz31G1NkucuR466acwk3rfEJe7KaXEs3KwjBxpf5",
    "decimals": 6,
    "enabled": true
  }
]

3. Initiate checkout

POST /api/v1/payments/crypto/checkout
  ?organization_id=239
  &credit_plan_id=11
  &quantity=1
  &token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Returns:

{
  "memo": "9df573b6419b5e7d...",
  "amount": 19000000,
  "recipient": "HYrGnz31G1NkucuR466acwk3rfEJe7KaXEs3KwjBxpf5",
  "token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
}

Field	Description
`memo`	Your payment ID — include this as the transaction memo when sending
`amount`	Amount in base units (divide by 10^decimals for the human amount, e.g. 19000000 / 10^6 = 19 USDC)
`recipient`	Wallet address to send to
`token`	Token mint address

4. Send the transaction from your wallet

Open Phantom (or any Solana wallet), send exactly amount of the token to recipient, and include the memo value as the transaction memo. The memo is how the system matches your payment to your account.

5. Confirm the payment

Once sent, submit your transaction hash:

PUT /api/v1/payments/crypto/confirm
  ?payment_id=9df573b6419b5e7d...
  &transaction_hash=<your_tx_hash>

The backend verifies the on-chain transaction and credits your organization’s balance.

Check Payment History

GET /api/v1/payments/history?limit=50&offset=0

Returns all payment sessions for your account, including pending (status 0) and confirmed (status 1).

Status	Meaning
`0`	Pending — checkout initiated, payment not yet confirmed
`1`	Confirmed — payment verified and credits applied