---
title: "Create an immutable stablecoin attempt"
method: POST
path: "/api/orders/checkout"
tags: ["Stablecoin"]
---

# Create an immutable stablecoin attempt

`POST /api/orders/checkout`

## Request

- Base URL: `https://vaanzari.com`
- URL: `https://vaanzari.com/api/orders/checkout`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `vaanzari_session`

This schema documents the additive stablecoin branch of storefront checkout. Existing fiat gateways remain available. An Idempotency-Key is required. Cookie clients must send x-csrf-token. The address, asset, amount and quote remain fixed; verified finalized receipt confirms the order independently of manual fiat settlement.

## Headers

- `Idempotency-Key` string, required

## Request body

- StablecoinCheckoutRequest
  - `payment_method` 'stablecoin', required
  - `payment_scope` 'international'
  - `stablecoin_rail` string, required
  - `stablecoin_quote` string, required
  - `shipping_address` string, required
  - `billing_address` string
  - `expected_total` number, required
  - `expected_currency` string, required

## Response `200`

Stablecoin operation result.

- StablecoinResponse
  - `success` boolean
  - `paymentAttemptId` integer
  - `orderId` integer, nullable
  - `orderNumber` integer, nullable
  - `status` string
  - `paymentStatus` string
  - `payment` StablecoinPayment
    - `provider` 'stablecoin', required
    - `quote` StablecoinQuote, required
      - `id` string, uuid, required
      - `rail` StablecoinRail, required
        - `id` string, required
        - `network` 'ethereum' | 'tron' | 'solana' | 'base' | 'arbitrum' | 'polygon' | 'avalanche', required
        - `networkName` string, required
        - `family` 'evm' | 'tron' | 'solana', required
        - `asset` 'USDC' | 'USDT' | 'USDT0', required
        - `contract` string, required
        - `decimals` unknown, required
        - `chainId` integer
      - `invoiceCurrency` string, required
      - `invoiceAmountMinor` string, required
      - `invoiceDecimals` integer, required
      - `amountAtomic` string, required
      - `amountDisplay` string, required
      - `usdPerAsset` string
      - `fiatPerUsd` string
      - `priceObservedAt` string, date-time
      - `fxObservedAt` string, date-time
      - `createdAt` string, date-time
      - `expiresAt` string, date-time, required
      - `rateSource` string
      - `signedQuote` string: Owner- and snapshot-bound quote. Present only in the quote response; send unchanged to checkout.
    - `receiver` string, required
    - `receivingAccount` string
    - `state` 'awaiting_payment' | 'paid' | 'review' | 'cancelled' | 'expired', required
    - `transactionHash` string
    - `fiatSettlementStatus` 'pending' | 'recorded', required
    - `canPay` boolean, required
  - `quote` StablecoinQuote
    - `id` string, uuid, required
    - `rail` StablecoinRail, required
      - `id` string, required
      - `network` 'ethereum' | 'tron' | 'solana' | 'base' | 'arbitrum' | 'polygon' | 'avalanche', required
      - `networkName` string, required
      - `family` 'evm' | 'tron' | 'solana', required
      - `asset` 'USDC' | 'USDT' | 'USDT0', required
      - `contract` string, required
      - `decimals` unknown, required
      - `chainId` integer
    - `invoiceCurrency` string, required
    - `invoiceAmountMinor` string, required
    - `invoiceDecimals` integer, required
    - `amountAtomic` string, required
    - `amountDisplay` string, required
    - `usdPerAsset` string
    - `fiatPerUsd` string
    - `priceObservedAt` string, date-time
    - `fxObservedAt` string, date-time
    - `createdAt` string, date-time
    - `expiresAt` string, date-time, required
    - `rateSource` string
    - `signedQuote` string: Owner- and snapshot-bound quote. Present only in the quote response; send unchanged to checkout.

## Other responses

- `400`: Invalid request.
- `409`: Immutable checkout, financial resolution, or quote conflict.
- `429`: Daily customer or shared custody allocation budget reached.
- `503`: Custody, rate, or independent chain verification unavailable.

---

[API](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api.md) · [All operations](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vaanzari/apis/vaanzari-agent-and-catalogue-api/revisions/1a8cc2dbe711?raw)