{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/marketsdk/json-schema/marketsdk-onboarding-link-object-schema.json",
  "title": "OnboardingLinkObject",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/marketsdk-sellers-api-openapi.yml#/components/schemas/OnboardingLinkObject",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "enum": [
        "onboarding_link"
      ]
    },
    "seller": {
      "type": "string"
    },
    "url": {
      "type": "string",
      "description": "Stripe-hosted onboarding, carrying your branding. Single use, and short-lived."
    },
    "expires_at": {
      "type": "string",
      "format": "date-time"
    },
    "payouts": {
      "$ref": "#/$defs/SellerPayoutsObject"
    }
  },
  "required": [
    "object",
    "seller",
    "url",
    "expires_at",
    "payouts"
  ],
  "$defs": {
    "SellerPayoutsObject": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "not_started",
            "pending",
            "enabled",
            "restricted"
          ],
          "description": "`not_started` before the first onboarding link; `pending` while Stripe onboarding is unfinished or under review; `enabled` when the seller can receive transfers; `restricted` when Stripe needs more from the seller."
        },
        "requirements_due": {
          "description": "What Stripe still needs from the seller, by Stripe's field names. Send a new onboarding link to collect it.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "stripe_account": {
          "type": [
            "string",
            "null"
          ],
          "description": "The seller's connected account on your Stripe account."
        }
      },
      "required": [
        "status",
        "requirements_due",
        "stripe_account"
      ]
    }
  }
}