{
  "name": "Square Payments",
  "slug": "square",
  "website_url": "https://squareup.com/us/en/payments",
  "vendor_description": "\"Square Payments Built for however you do business\" - Square Payments is a comprehensive payment processing solution for in-person, online, and mobile transactions.",
  "categories": [
    "card-acquiring"
  ],
  "summary": "Square Payments is a REST API for in-person, online, and mobile payment processing, covering use cases from hosted checkout and payment links to recurring subscriptions and marketplace payments. It operates in eight countries including the US, UK, Canada, Australia, and Japan, with published per-transaction pricing starting at $0.30 plus a percentage and a self-serve signup path. The API supports OAuth2 and API key auth, webhooks, idempotency, and ships official SDKs for seven languages including Node.js, Python, and Go. Security certifications include PCI DSS Level 1, SOC 2 Type 2, ISO 27001, and GDPR compliance.",
  "capabilities": {
    "supported_actions": [
      "create_payment",
      "update_payment",
      "complete_payment",
      "list_payments",
      "refunds",
      "hosted_checkout",
      "payment_links",
      "tokenization",
      "3ds_authentication",
      "recurring_payments",
      "card_on_file",
      "dispute_management",
      "apple_pay",
      "google_pay",
      "cash_app_pay",
      "afterpay_clearpay",
      "ach_bank_transfer",
      "in_person_terminal",
      "fraud_screening",
      "subscriptions",
      "invoices",
      "multicurrency",
      "delayed_capture",
      "application_fees",
      "webhook_events",
      "oauth"
    ],
    "supported_regions": [
      "United States",
      "Canada",
      "Australia",
      "United Kingdom",
      "Ireland",
      "France",
      "Spain",
      "Japan"
    ],
    "supported_languages": [],
    "input_types": [
      "Visa",
      "Mastercard",
      "American Express",
      "Discover",
      "JCB",
      "UnionPay International",
      "Diners Club",
      "Interac",
      "EFTPOS",
      "Apple Pay",
      "Google Pay",
      "Cash App Pay",
      "Afterpay/Clearpay",
      "ACH bank transfer",
      "Square gift cards",
      "Bitcoin",
      "Cash"
    ],
    "output_types": [
      "JSON",
      "webhook events",
      "hosted checkout page",
      "payment link",
      "settlement report",
      "payout tracking",
      "dispute management"
    ],
    "webhooks_supported": true,
    "sandbox_available": true,
    "sdk_languages": [
      "Node.js",
      "Python",
      "Java",
      ".NET",
      "PHP",
      "Ruby",
      "Go"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://connect.squareup.com/v2",
    "api_version": "2026-05-20",
    "versioning_scheme": "header",
    "stability": "ga",
    "deprecation_policy_url": "https://developer.squareup.com/docs/build-basics/api-lifecycle",
    "auth_methods": [
      "oauth2",
      "api_key"
    ],
    "auth_docs_url": "https://developer.squareup.com/docs/oauth-api/overview",
    "idempotency_supported": true,
    "error_format": "vendor-specific",
    "webhook_signing": "hmac_sha256",
    "webhook_events_url": "https://developer.squareup.com/docs/webhooks/v2webhook-events-tech-ref",
    "rate_limit_requests": null,
    "rate_limit_window": null,
    "sdk_packages": [
      {
        "package": "square",
        "language": "Node.js",
        "official": true,
        "repo_url": "https://github.com/square/square-nodejs-sdk"
      },
      {
        "package": "squareup",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/square/square-python-sdk"
      },
      {
        "package": "com.squareup:square",
        "language": "Java",
        "official": true,
        "repo_url": "https://github.com/square/square-java-sdk"
      },
      {
        "package": "Square",
        "language": ".NET",
        "official": true,
        "repo_url": "https://github.com/square/square-dotnet-sdk"
      },
      {
        "package": "square/square",
        "language": "PHP",
        "official": true,
        "repo_url": "https://github.com/square/square-php-sdk"
      },
      {
        "package": "square.rb",
        "language": "Ruby",
        "official": true,
        "repo_url": "https://github.com/square/square-ruby-sdk"
      },
      {
        "package": "github.com/square/square-go-sdk/v2",
        "language": "Go",
        "official": true,
        "repo_url": "https://github.com/square/square-go-sdk"
      }
    ],
    "mcp_url": "https://mcp.squareup.com/sse",
    "quickstart_url": "https://developer.squareup.com/docs/get-started"
  },
  "pricing": {
    "pricing_model": "hybrid",
    "has_published_pricing": true,
    "starting_price_usd": "0.3000",
    "price_basis": "transaction + percent",
    "free_tier_available": false,
    "free_tier_limit": null,
    "free_tier_details": null,
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": true,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Free",
        "item": "In-person transaction (tap, dip, or swipe)",
        "amount_usd": "0.1500",
        "amount_percent": "2.6000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Plus",
        "item": "In-person transaction (tap, dip, or swipe)",
        "amount_usd": "0.1500",
        "amount_percent": "2.5000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Premium",
        "item": "In-person transaction (tap, dip, or swipe)",
        "amount_usd": "0.1500",
        "amount_percent": "2.4000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Free",
        "item": "Online or invoice transaction",
        "amount_usd": "0.3000",
        "amount_percent": "3.3000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Plus",
        "item": "Online or invoice transaction",
        "amount_usd": "0.3000",
        "amount_percent": "2.9000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Premium",
        "item": "Online or invoice transaction",
        "amount_usd": "0.3000",
        "amount_percent": "2.9000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": null,
        "item": "Online API transaction (all plans)",
        "amount_usd": "0.3000",
        "amount_percent": "2.9000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": null,
        "item": "Manual entry or card on file transaction (all plans)",
        "amount_usd": "0.1500",
        "amount_percent": "3.5000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": null,
        "item": "Afterpay transaction (all plans)",
        "amount_usd": "0.3000",
        "amount_percent": "6.0000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": null,
        "item": "ACH bank transfer (1% rate, $1 minimum, plan-dependent caps)",
        "amount_usd": "1.0000",
        "amount_percent": "1.0000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": null,
        "item": "International card surcharge",
        "amount_usd": null,
        "amount_percent": "1.5000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": "Free",
        "item": "Gift card load fee",
        "amount_usd": null,
        "amount_percent": "2.5000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": "Plus",
        "item": "Gift card load fee",
        "amount_usd": null,
        "amount_percent": "2.5000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": "Premium",
        "item": "Gift card load fee",
        "amount_usd": null,
        "amount_percent": "0.0000",
        "per": "transaction",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": null,
        "item": "Instant or same-day transfer to bank",
        "amount_usd": null,
        "amount_percent": "1.9500",
        "per": "transfer",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/instant-transfers"
      },
      {
        "plan": null,
        "item": "Standard next-business-day transfer to bank",
        "amount_usd": null,
        "amount_percent": "0.0000",
        "per": "transfer",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/instant-transfers"
      },
      {
        "plan": null,
        "item": "Bitcoin conversion fee",
        "amount_usd": null,
        "amount_percent": "1.0000",
        "per": "conversion",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": null,
        "item": "Bitcoin rush withdrawal fee",
        "amount_usd": "2.0000",
        "amount_percent": null,
        "per": "withdrawal",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": null,
        "item": "Bitcoin priority withdrawal fee",
        "amount_usd": "3.0000",
        "amount_percent": null,
        "per": "withdrawal",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      },
      {
        "plan": "Free",
        "item": "Monthly account fee",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Plus",
        "item": "Monthly account fee",
        "amount_usd": "49.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": "Premium",
        "item": "Monthly account fee",
        "amount_usd": "149.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://squareup.com/us/en/payments/our-fees"
      },
      {
        "plan": null,
        "item": "Chargeback / dispute fee",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "chargeback",
        "currency": "USD",
        "source_url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": null,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": false,
    "sla_url": null,
    "data_retention_policy_url": "https://squareup.com/us/en/legal/general/privacy",
    "documented_rate_limits": "GraphQL API: 10 queries per second (10 QPS), max complexity 250 per query; REST API rate limits enforced but not publicly documented (429 RATE_LIMITED returned when exceeded)",
    "known_restrictions": [
      "PCI DSS Level 1 certified",
      "ACH bank transfers US-only",
      "Cash App Pay US-only",
      "Cross-border card payments not supported (must process in country of account activation)",
      "Sellers processing over $250,000/year may qualify for custom rates (requires contacting sales)",
      "Bitcoin processing fee waived until December 31, 2026",
      "Subscriptions API does not support ACH payments",
      "Prohibited: firearms/ammunition sales, illegal goods/services"
    ]
  },
  "developer": {
    "docs_url": "https://developer.squareup.com/us/en",
    "api_reference_url": null,
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": "https://squareup.com/whats-new",
    "status_page_url": null,
    "llms_txt_url": "https://squareup.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2010-01-01",
    "ga_date": null,
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Shake Shack",
      "Boston Beer Company"
    ]
  },
  "scores": {
    "agent_friendliness": 65,
    "pricing_transparency": 85,
    "setup_speed": 75,
    "docs_quality": 35,
    "procurement_friction": 85,
    "trust_readiness": 65,
    "best_for": [
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)",
      "Teams needing broad API coverage out of the box"
    ],
    "avoid_if": [
      "You want to try it free before paying"
    ]
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://squareup.com/us/en/payments",
      "excerpt": "Square Payments Built for however you do business",
      "confidence": "high"
    },
    {
      "field": "pricing_model (hybrid)",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "In-person (tap/dip/swipe): Free: 2.6% + 15¢; Plus: 2.5% + 15¢; Premium: 2.4% + 15¢",
      "confidence": "high"
    },
    {
      "field": "has_published_pricing",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "Square Free: 2.6% + 15¢ in-person; 3.3% + 30¢ online; Square Plus: 2.5% + 15¢ in-person; 2.9% + 30¢ online; Square Premium: 2.4% + 15¢ in-person; 2.9% + 30¢ online",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "If you process over $250,000 per year, talk to our team",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://squareup.com/us/en/security/details",
      "excerpt": "As the merchant of record, we maintain PCI certification so you don't have to individually validate your compliance.",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://squareup.com/us/en/the-bottom-line/operating-your-business/pci-compliance",
      "excerpt": "In addition to PCI Compliance, Square is also SOC 1, 2, and ISO27001 compliant.",
      "confidence": "medium"
    },
    {
      "field": "gdpr",
      "url": "https://squareup.com/us/en/legal/general/data-processing-terms",
      "excerpt": "Square Europe, Square International, and their affiliates are subject to European Directive 2002/58/EC (the \"e-Privacy Directive\") and the General Data Protection Regulation (EU) 2016/679 (\"GDPR\")",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://developer.squareup.com/docs/payment-card-support-by-country",
      "excerpt": "US: Visa, Mastercard, Amex, Discover, Discover Diners, JCB, UnionPay International; Digital wallets: Apple Pay and Google Pay available across all countries; Cash App Pay is US-only; ACH: US only; Afterpay/Clearpay: Australia, Canada, UK, US",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://developer.squareup.com/docs/payment-card-support-by-country",
      "excerpt": "Supported countries: Australia, Canada, France, Ireland, Japan, Spain, United Kingdom, United States",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://developer.squareup.com/docs/mcp",
      "excerpt": "The Square MCP server connects your AI tools directly to the full Square API platform. The remote MCP server URL is https://mcp.squareup.com/sse. The server is currently in Beta.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developer.squareup.com/docs/build-basics/general-considerations/handling-errors",
      "excerpt": "If your application sends a high number of requests to Square APIs in a short period of time, Square might temporarily stop processing your requests and return RATE_LIMITED errors with a 429 Too Many Requests status. Square API endpoints might enforce different rate limits.",
      "confidence": "high"
    },
    {
      "field": "sandbox_available",
      "url": "https://developer.squareup.com/docs/payments-api/overview",
      "excerpt": "if you test the Payments API in the Square Sandbox, they appear in the Sandbox Square Dashboard",
      "confidence": "high"
    },
    {
      "field": "known_restrictions (Bitcoin fee until Dec 31 2026)",
      "url": "https://squareup.com/help/us/en/article/5068-what-are-square-s-fees",
      "excerpt": "Bitcoin payments: 0% processing fees until December 31, 2026",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developer.squareup.com/docs/oauth-api/overview",
      "excerpt": "The Square OAuth API uses the OAuth 2 protocol to obtain permission from Square sellers to access specific types of resources in their account.",
      "confidence": "high"
    },
    {
      "field": "auth_docs_url",
      "url": "https://developer.squareup.com/docs/oauth-api/overview",
      "excerpt": "The Square OAuth API uses the OAuth 2 protocol to obtain permission from Square sellers to access specific types of resources in their account.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developer.squareup.com/reference/square/payments-api/create-payment",
      "excerpt": "The request example uses https://connect.squareup.com/v2/payments as the endpoint for creating payments.",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://developer.squareup.com/reference/square",
      "excerpt": "Current API version: 2026-05-20 (referenced twice in the documentation)",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://developer.squareup.com/docs/build-basics/versioning-overview",
      "excerpt": "Regardless of whether you explicitly specify a version in the request, the response always returns the `Square-Version` header so you know which API version is used.",
      "confidence": "high"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://developer.squareup.com/docs/build-basics/api-lifecycle",
      "excerpt": "APIs are typically deprecated at least 12 months before permanent retirement. Deprecated functionality remains publicly available and fully supported, but its use is strongly discouraged for all applications.",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://developer.squareup.com/docs/sdks",
      "excerpt": "Go: github.com/square/square-go-sdk/v2; Java: com.squareup:square; .NET: Square; Node.js: square; PHP: square/square; Python: squareup; Ruby: square.rb",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://developer.squareup.com/docs/mcp",
      "excerpt": "Square recommends using the remote MCP server, which supports OAuth login with more control and granular permissions.",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://developer.squareup.com/docs/build-basics/common-api-patterns/idempotency",
      "excerpt": "An API call or operation is idempotent if it has the same result no matter how many times it's applied.",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://developer.squareup.com/docs/build-basics/general-considerations/handling-errors",
      "excerpt": "{\"errors\": [{\"category\": \"AUTHENTICATION_ERROR\", \"code\": \"UNAUTHORIZED\", \"detail\": \"This request could not be authorized.\"}]}",
      "confidence": "high"
    },
    {
      "field": "categories (payments only — payouts removed)",
      "url": "https://developer.squareup.com/docs/payouts-api/overview",
      "excerpt": "A payout is a transfer of funds from a seller's Square account to another banking destination, most often the seller's external bank account. The Payouts API enables developers to track and reconcile funds transferred from a seller's Square account to another banking destination.",
      "confidence": "high"
    },
    {
      "field": "pricing_model (hybrid)",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "Monthly account fee — Free: $0; Plus: $49/mo; Premium: $149/mo",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://squareup.com/us/en/the-bottom-line/managing-your-finances/credit-card-processing-fees-and-rates",
      "excerpt": "businesses exceeding $250,000 annually may qualify for a competitive custom rate by contacting sales",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://squareup.com/help/us/en/article/3797-secure-data-encryption",
      "excerpt": "Square's card processing systems meet Level 1 PCI Data Security Standards",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://squareup.com/us/en/the-bottom-line/operating-your-business/pci-compliance",
      "excerpt": "In addition to PCI Compliance, Square is also SOC 1, 2, and ISO27001 compliant.",
      "confidence": "medium"
    },
    {
      "field": "soc2",
      "url": "https://squareup.com/help/us/en/article/3797-secure-data-encryption",
      "excerpt": "PCI and SOC reports and related documentation available through the Square Trust Center",
      "confidence": "medium"
    },
    {
      "field": "gdpr",
      "url": "https://squareup.com/us/en/legal/general/data-processing-terms",
      "excerpt": "Square and its affiliates are data processors when accessing personal data of customers in the course of providing services",
      "confidence": "high"
    },
    {
      "field": "input_types",
      "url": "https://developer.squareup.com/docs/payments-api/overview",
      "excerpt": "Card payments, ACH bank transfers, Afterpay/Clearpay, Cash App Pay, Cash payments, External payments, House accounts",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://developer.squareup.com/docs/sdks",
      "excerpt": "Square offers server-side SDKs in: Go, Java, .NET, Node.js, PHP, Python, Ruby. Mobile: Mobile Payments SDK for iOS, Android, Flutter, and React Native.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developer.squareup.com/docs/devtools/graphql",
      "excerpt": "Applications can send a maximum of 10 queries per second (10 QPS), and a query can have a maximum complexity score of 250 points",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://developer.squareup.com/docs/webhooks/overview",
      "excerpt": "When events occur, Square sends POST requests containing JSON data to your endpoint. Square implements exponential backoff retry logic spanning 24 hours. The system attempts delivery 11 times.",
      "confidence": "high"
    },
    {
      "field": "self_serve_signup",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "Square Free: Only pay when you take a payment; No hidden fees or locked-in contracts. Cancel or switch anytime.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions (PCI Level 1)",
      "url": "https://squareup.com/help/us/en/article/3797-secure-data-encryption",
      "excerpt": "Square's card processing systems meet Level 1 PCI Data Security Standards",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developer.squareup.com/docs/build-basics/access-tokens",
      "excerpt": "A personal access token is a full-access credential for development and production use on your own Square account. Obtained from the Developer Console Credentials page.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developer.squareup.com/docs/build-basics/versioning-overview",
      "excerpt": "curl https://connect.squareup.com/v2/payments \\ -H 'Square-Version: 2024-07-17'",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://developer.squareup.com/reference/square/payments-api/create-payment",
      "excerpt": "The examples and documentation reference API version 2026-05-20, which is specified in the request headers via the Square-Version parameter.",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://developer.squareup.com/docs/build-basics/versioning-overview",
      "excerpt": "Include the `Square-Version` header to test different versions: -H 'Square-Version: 2024-07-17'",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://developer.squareup.com/docs/build-basics/api-lifecycle",
      "excerpt": "General Availability (GA) — 'Ready for production use' with full support for new functionality and bug fixes",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://developer.squareup.com/docs/sdks",
      "excerpt": "Square recommends using the Square server-side SDKs instead of calling APIs directly from your application as they provide useful abstractions to simplify development.",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://developer.squareup.com/docs/mcp",
      "excerpt": "Remote: https://mcp.squareup.com/sse",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://developer.squareup.com/docs/get-started",
      "excerpt": "Get Started guide at /docs/get-started/create-account-and-application",
      "confidence": "high"
    },
    {
      "field": "idempotency_supported",
      "url": "https://developer.squareup.com/reference/square/payments-api/create-payment",
      "excerpt": "The idempotency_key is 'A unique string that identifies this CreatePayment request. Keys can be any valid string but must be unique for every CreatePayment request.'",
      "confidence": "high"
    },
    {
      "field": "error_format",
      "url": "https://developer.squareup.com/docs/build-basics/general-considerations/handling-errors",
      "excerpt": "The Error object uses fields: category — A high-level classification of the error; code — Specific identifier mapped to ErrorCode enum; detail — Optional human-readable description for developers; field — Optional field name from the original request that caused the error",
      "confidence": "high"
    },
    {
      "field": "webhook_signing",
      "url": "https://developer.squareup.com/docs/webhooks/step3validate",
      "excerpt": "All webhook notifications from Square include an `x-square-hmacsha256-signature` header. The value of this header is an HMAC-SHA-256 signature generated using: The signature key for your webhook subscription. The notification URL for your webhook subscription. The raw body of the request.",
      "confidence": "high"
    },
    {
      "field": "webhook_events_url",
      "url": "https://developer.squareup.com/docs/webhooks/v2webhook-events-tech-ref",
      "excerpt": "The page documents extensive webhook events across 24+ Square APIs, including bank_account.created, payment.created, payment.updated, order.created, refund.created",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://developer.squareup.com/forums/t/current-square-api-rate-limit/449",
      "excerpt": "At this time we currently do not publicly disclose the rate limits",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://squareup.com/help/us/en/article/8663-verify-your-identity-and-square-business-information",
      "excerpt": "There is no way to activate your Square account to accept payments without all applicable parties completing verification.",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://squareup.com/help/us/en/article/8663-verify-your-identity-and-square-business-information",
      "excerpt": "If identity verification is unsuccessful, you will be unable to process payments with Square at this time.",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "Online API: All plans: 2.9% + 30¢",
      "confidence": "high"
    },
    {
      "field": "price_basis",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "Card-Present (Tap, Dip, Swipe): Free: 2.6% + 15¢; Online API: All plans: 2.9% + 30¢",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://squareup.com/us/en/the-bottom-line/podcasts/the-square-developer-podcast/monstarlab",
      "excerpt": "Shake Shack built custom self-service kiosks that streamline ordering, powered by Square Reader SDK.",
      "confidence": "medium"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://squareup.com/us/en/legal/general/privacy",
      "excerpt": "Square retains personal information for as long as is necessary for the purposes identified in this Privacy Notice, including to provide our Services, to comply with legal obligations",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://squareup.com/us/en/payments/our-fees",
      "excerpt": "Online Payments: Free: 3.3% + 30¢",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://en.wikipedia.org/wiki/Block,_Inc.",
      "excerpt": "Jack Dorsey co-founded Square in 2009, and it launched in 2010.",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://squareup.com/us/en/townsquare/case-studies",
      "excerpt": "The Boston Beer Company launched an online store that showcases their brands and makes managing inventory and order fulfillment simple through Square.",
      "confidence": "medium"
    }
  ],
  "fields_not_found": [
    "hipaa",
    "sla_published",
    "soc2_type_explicit_source",
    "rate_limit_requests",
    "rate_limit_window",
    "sla_url",
    "ga_date"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-21T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/square",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/square/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add (only name is required - send as much as you can cite)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme Email API",
            "website_url": "https://acme.example",
            "vendor_name": "Acme",
            "categories": [
              "email"
            ],
            "pricing_model": "usage_based",
            "has_published_pricing": true,
            "free_tier_available": true,
            "price_points": [
              {
                "plan": "Pay as you go",
                "item": "1,000 emails",
                "amount_usd": 1,
                "per": "1,000 emails",
                "source_url": "https://acme.example/pricing"
              }
            ],
            "soc2": "type_2",
            "docs_url": "https://docs.acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example/pricing",
              "excerpt": "$1 per 1,000 emails"
            }
          ]
        },
        "value_schema": [
          {
            "field": "name",
            "type": "string",
            "label": "Product name (the only required field)"
          },
          {
            "field": "website_url",
            "type": "string",
            "label": "Marketing website URL"
          },
          {
            "field": "vendor_name",
            "type": "string",
            "label": "Company/vendor name behind the product"
          },
          {
            "field": "vendor_description",
            "type": "string",
            "label": "One-line description, quoted from the vendor"
          },
          {
            "field": "categories",
            "type": "string[]",
            "label": "Category/leaf slugs it belongs to, e.g. [\"email\",\"sms\"]"
          },
          {
            "field": "primary_use_cases",
            "type": "string[]",
            "label": "What it's used for"
          },
          {
            "field": "supported_actions",
            "type": "string[]",
            "label": "Concrete API actions/capabilities"
          },
          {
            "field": "supported_regions",
            "type": "string[]",
            "label": "Countries/regions/data-residency"
          },
          {
            "field": "supported_languages",
            "type": "string[]",
            "label": "Human/spoken languages supported"
          },
          {
            "field": "input_types",
            "type": "string[]",
            "label": "Accepted input types/formats"
          },
          {
            "field": "output_types",
            "type": "string[]",
            "label": "Produced output types/formats"
          },
          {
            "field": "webhooks_supported",
            "type": "bool",
            "label": "Supports webhooks?"
          },
          {
            "field": "sandbox_available",
            "type": "bool",
            "label": "Dedicated sandbox/test mode?"
          },
          {
            "field": "sdk_languages",
            "type": "string[]",
            "label": "Languages with an official SDK"
          },
          {
            "field": "mcp_server_available",
            "type": "bool",
            "label": "Official MCP server?"
          },
          {
            "field": "pricing_model",
            "type": "enum",
            "label": "Pricing model",
            "values": [
              "usage_based",
              "subscription",
              "seat_based",
              "hybrid",
              "contact_sales"
            ]
          },
          {
            "field": "has_published_pricing",
            "type": "bool",
            "label": "Concrete prices published publicly?"
          },
          {
            "field": "free_tier_available",
            "type": "bool",
            "label": "Recurring/perpetual free tier (not a trial)?"
          },
          {
            "field": "free_tier_details",
            "type": "string",
            "label": "What the free tier includes"
          },
          {
            "field": "minimum_commitment",
            "type": "string",
            "label": "Any stated minimum spend/commitment"
          },
          {
            "field": "self_serve_signup",
            "type": "bool",
            "label": "Get an API key without talking to sales?"
          },
          {
            "field": "requires_sales_call",
            "type": "bool",
            "label": "Does going live require sales?"
          },
          {
            "field": "enterprise_plan_available",
            "type": "bool",
            "label": "Named enterprise tier?"
          },
          {
            "field": "starting_price_usd",
            "type": "number",
            "label": "Lowest published paid entry price (USD number)"
          },
          {
            "field": "price_basis",
            "type": "string",
            "label": "Unit the starting price is per, e.g. '1,000 emails'"
          },
          {
            "field": "free_tier_limit",
            "type": "string",
            "label": "Free-tier ceiling in literal terms"
          },
          {
            "field": "price_points",
            "type": "object[]",
            "label": "Structured prices: [{plan,item,amount_usd,amount_percent,per,source_url}]"
          },
          {
            "field": "soc2",
            "type": "enum",
            "label": "SOC 2 status",
            "values": [
              "type_2",
              "type_1",
              "in_progress",
              "none",
              "unknown"
            ]
          },
          {
            "field": "hipaa",
            "type": "bool",
            "label": "HIPAA (e.g. BAA available)?"
          },
          {
            "field": "gdpr",
            "type": "bool",
            "label": "GDPR compliance stated?"
          },
          {
            "field": "iso_27001",
            "type": "bool",
            "label": "ISO 27001 certified?"
          },
          {
            "field": "pci_dss",
            "type": "bool",
            "label": "PCI DSS compliant?"
          },
          {
            "field": "sla_published",
            "type": "bool",
            "label": "Published SLA / uptime commitment?"
          },
          {
            "field": "documented_rate_limits",
            "type": "string",
            "label": "Documented rate limits, quoted"
          },
          {
            "field": "known_restrictions",
            "type": "string[]",
            "label": "Notable documented restrictions/limits"
          },
          {
            "field": "auth_methods",
            "type": "string[]",
            "label": "Auth methods",
            "values": [
              "api_key",
              "oauth2",
              "jwt",
              "basic",
              "hmac_signature",
              "mtls",
              "session"
            ]
          },
          {
            "field": "api_style",
            "type": "enum",
            "label": "Primary API style",
            "values": [
              "rest",
              "graphql",
              "grpc",
              "soap",
              "websocket"
            ]
          },
          {
            "field": "base_url",
            "type": "string",
            "label": "API root/base URL"
          },
          {
            "field": "api_version",
            "type": "string",
            "label": "Current API version string"
          },
          {
            "field": "quickstart_url",
            "type": "string",
            "label": "Quickstart / hello-world URL"
          },
          {
            "field": "docs_url",
            "type": "string",
            "label": "Developer docs URL"
          },
          {
            "field": "api_reference_url",
            "type": "string",
            "label": "API reference URL"
          },
          {
            "field": "openapi_spec_url",
            "type": "string",
            "label": "OpenAPI spec URL"
          },
          {
            "field": "changelog_url",
            "type": "string",
            "label": "Changelog URL"
          },
          {
            "field": "status_page_url",
            "type": "string",
            "label": "Status page URL"
          },
          {
            "field": "notable_customers",
            "type": "string[]",
            "label": "Named public customers"
          },
          {
            "field": "launched_at",
            "type": "string",
            "label": "Launch date (ISO date or year)"
          }
        ]
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}