{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/fiatdock-com/json-schema/fiatdock-com-session-schema.json",
  "title": "Session",
  "description": "A created ramp session. Forward checkoutUrl to the human owner (valid ~2 hours).",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/fiatdock-com-offramp-api-openapi.yml#/components/schemas/Session",
  "type": "object",
  "properties": {
    "partnerOrderId": {
      "type": "string",
      "description": "Order id — track it with get_order_status"
    },
    "provider": {
      "type": "string",
      "description": "Licensed fiat provider handling this session (e.g. mtpelerin)"
    },
    "checkoutUrl": {
      "type": "string",
      "description": "Branded checkout URL (valid ~2 hours) — forward to the human owner"
    },
    "note": {
      "type": "string",
      "description": "Next-step instructions"
    },
    "emailedTo": {
      "type": "string",
      "description": "Present when an `email` was supplied and email is configured: the checkout link was also emailed to this address (best-effort)"
    },
    "customerKey": {
      "type": "string",
      "description": "Returned ONCE on the first session with a new customerId — store securely"
    },
    "customerKeyNote": {
      "type": "string",
      "description": "How to use customerKey"
    }
  },
  "required": [
    "partnerOrderId",
    "checkoutUrl"
  ]
}