{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/genesispay-finance/json-schema/genesispay-finance-post-api-v1-links-request-schema.json",
  "title": "PostApiV1LinksRequest",
  "x-generated": "2026-11-09",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/genesispay-finance-openapi-generated.yml#/components/schemas/PostApiV1LinksRequest",
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "required, <= 120 chars"
    },
    "description": {
      "type": "string",
      "description": "optional, <= 1000 chars"
    },
    "amount": {
      "type": "string",
      "description": "required, decimal string in \"asset\""
    },
    "asset": {
      "type": "string",
      "description": "USDC-only creation during beta"
    },
    "destinationWallet": {
      "type": "string",
      "description": "optional, defaults to your GenesisPay wallet"
    },
    "linkType": {
      "type": "string",
      "description": "\"single\" optional; \"reusable\" is rejected (422)"
    },
    "lineItems": {
      "type": "array",
      "description": "array of objects with name, quantity, amount"
    },
    "taxConfig": {
      "type": "object",
      "description": "tax configuration object"
    },
    "metadata": {
      "type": "object",
      "description": "flat string map"
    },
    "clientReferenceId": {
      "type": "string",
      "description": "optional, <= 200 chars"
    },
    "returnUrl": {
      "type": "string",
      "description": "optional, https"
    },
    "cancelUrl": {
      "type": "string",
      "description": "optional, https"
    }
  },
  "required": [
    "title",
    "amount"
  ]
}