request_offer

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "product": {
      "description": "The single rail in scope. Accepted: banking, acquiring, digital-assets (alias crypto), fixed-txn, kyc, baas, vibans, agentic, corridor (alias cross-border - the real-time EUR <-> USD settlement corridor), open_banking (aliases pay-by-bank, open-banking - account-to-account collection in EU/UK payer markets). Same accepted set as get_indicative_price.",
      "type": "string",
      "enum": [
        "banking",
        "acquiring",
        "digital-assets",
        "cross-border",
        "open-banking",
        "kyc",
        "baas",
        "vibans",
        "agentic",
        "payment-ops",
        "compliance-automation",
        "payouts",
        "current"
      ]
    },
    "contact": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "work_email": {
          "type": "string",
          "maxLength": 255,
          "format": "email",
          "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        }
      },
      "required": [
        "name",
        "work_email"
      ]
    },
    "company": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "regions": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      }
    },
    "vertical": {
      "type": "string",
      "maxLength": 60
    },
    "monthly_volume": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 10000000000
    },
    "current_rate": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000
    },
    "unit": {
      "type": "string",
      "enum": [
        "bps",
        "%",
        "per-txn",
        "per-check"
      ]
    },
    "currency": {
      "type": "string",
      "enum": [
        "EUR",
        "USD",
        "GBP"
      ]
    },
    "licensed": {
      "type": "boolean"
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "timeline_target": {
      "description": "OPTIONAL. The client's timing target from the register's go-live question, in their own words - a date, a range or 'no fixed date' (e.g. 'before December', '60 days', 'Q1'). Record what they said; never infer one and never state a timeline back to the client.",
      "type": "string",
      "maxLength": 120
    },
    "timeline_driver": {
      "description": "OPTIONAL. What is driving that timing, verbatim from the client (e.g. 'our current provider is exiting gambling', 'the contract ends in November'). Free text, never summarised into a category.",
      "type": "string",
      "maxLength": 300
    },
    "target_price": {
      "description": "OPTIONAL. The client's desired target rate, in the same unit as `current_rate` (e.g. bps for banking/digital-assets). Set ONLY when the client has stated a target BELOW the indicative range and confirmed they want it logged. Logging a target moves the deal to Negotiation for commercial-team review; it is NEVER a confirmed rate. Do not populate to 'test' whether a rate is available - the tool never returns approval or rejection of a target.",
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 1000000
    },
    "target_note": {
      "description": "OPTIONAL free-form note attached to a logged target_price (e.g. 'client says a competitor is at 15').",
      "type": "string",
      "maxLength": 500
    },
    "consent": {
      "type": "boolean",
      "const": true,
      "description": "Must be true. The caller confirms the client consents to Crosswire processing this request."
    },
    "caller_client_id": {
      "description": "Optional stable ID for the calling agent/platform, used for rate limiting and CRM attribution.",
      "type": "string",
      "maxLength": 120
    },
    "rails": {
      "description": "The capability rails in scope, if any architecture was designed. If more than one rail is present this tool routes the submission to the Crosswire offer engine automatically - use create_solution_offer directly instead.",
      "maxItems": 24,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 60
      }
    },
    "cw_sid": {
      "description": "Optional attribution key for this conversation. Omit unless the flow already carries one.",
      "type": "string",
      "maxLength": 120
    }
  },
  "required": [
    "contact",
    "company",
    "consent"
  ]
}