VerifyBeforePayIn

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/farofinance-app/json-schema/farofinance-app-verify-before-pay-in-schema.json",
  "title": "VerifyBeforePayIn",
  "description": "Body for `POST /v1/verify/before-pay` — the raw protocol payload path.\n\nSend the protocol payload as-is (an x402 402 challenge body, an AP2\nCart/Payment mandate, or an ACP checkout context); Faro's adapter extracts\nthe counterparty artifacts. Prefer this over `/v1/verify/payment-intent`\nwhen you hold the actual protocol object — no field-mapping on your side.",
  "x-generated": "2026-11-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/farofinance-app-api-openapi.json#/components/schemas/VerifyBeforePayIn",
  "properties": {
    "protocol": {
      "$ref": "#/$defs/AgentPayProtocol",
      "description": "Which agent-payment protocol produced `payload` (`ap2`, `x402`, `acp`)."
    },
    "payload": {
      "additionalProperties": true,
      "type": "object",
      "title": "Payload",
      "description": "The protocol object itself: the 402 challenge JSON (x402), the CartMandate/PaymentMandate (AP2), or the merchant + checkout context (ACP)."
    },
    "region": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2,
          "minLength": 2
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "description": "Optional ISO 3166-1 alpha-2 region hint (e.g. `IN`, `US`) used only to interpret a *bare* phone number that has no country code. Labelling context only — it never changes the reputation node, sanctions, or the verdict. A number written in full `+<country code>` form is identified regardless."
    }
  },
  "type": "object",
  "required": [
    "protocol",
    "payload"
  ],
  "$defs": {
    "AgentPayProtocol": {
      "type": "string",
      "enum": [
        "ap2",
        "x402",
        "acp"
      ],
      "title": "AgentPayProtocol"
    }
  }
}