Beanstream Payments

{
  "service_type": "platform",
  "base_url": "https://www.beanstream.com",
  "auth_method": "api_key",
  "auth_config": {
    "header": "Merchant ID and API key required for authentication",
    "api_key_placeholder": "X-API-Key or Authorization header with Merchant ID and API Passcode"
  },
  "endpoints": [
    {
      "path": "/api/v1/payments",
      "method": "POST",
      "description": "Create a payment (sale, pre-auth, etc.)"
    },
    {
      "path": "/api/v1/payments/{id}",
      "method": "GET",
      "description": "Retrieve payment details"
    },
    {
      "path": "/api/v1/payments/{id}/approve",
      "method": "POST",
      "description": "Approve a pre-authorized payment"
    },
    {
      "path": "/api/v1/payments/{id}/void",
      "method": "POST",
      "description": "Void a payment"
    },
    {
      "path": "/api/v1/payments/{id}/returns",
      "method": "POST",
      "description": "Process a return/refund"
    },
    {
      "path": "/api/v1/payment-methods",
      "method": "GET",
      "description": "List payment methods (e.g., credit card profiles)"
    },
    {
      "path": "/api/v1/profiles",
      "method": "POST",
      "description": "Create a customer profile"
    },
    {
      "path": "/api/v1/profiles/{id}",
      "method": "GET",
      "description": "Retrieve customer profile"
    },
    {
      "path": "/api/v1/profiles/{id}/cards",
      "method": "POST",
      "description": "Add card to profile"
    },
    {
      "path": "/api/v1/transactions/reports",
      "method": "GET",
      "description": "Query transaction reports"
    },
    {
      "path": "/api/v1/transactions/{id}",
      "method": "GET",
      "description": "Retrieve transaction details"
    }
  ],
  "pricing_model": {
    "type": "subscription",
    "details": {
      "cost": "Variable, based on transaction volume and plan; contact sales or refer to partner pricing",
      "trial": "Not specified",
      "additional_fees": "Per-transaction processing fees likely apply; merchant account required"
    }
  },
  "rate_limits": {
    "general": "Not publicly documented; typical for payment APIs, may have throttling per merchant",
    "notes": "Check official documentation for specifics"
  },
  "capabilities": [
    "Payment processing (authorize, capture, void, refund)",
    "Support for multiple payment methods (credit cards, debit, etc.)",
    "Customer profile management (tokenization, vault)",
    "Recurring billing / subscriptions",
    "Reporting and transaction search",
    "Fraud protection tools",
    "Hosted payment pages",
    "Pre-authorization (pre-auth) and settlement",
    "Interac support (Canadian market)",
    "Currency conversion",
    "API documentation and developer portal",
    "Webhooks for notifications"
  ],
  "raw_analysis": "Beanstream is a payment gateway platform primarily serving the Canadian market, but also expanding internationally. It is a mature payment processing service (part of Bambora after acquisition) designed for businesses of all sizes to accept payments online, on mobile, and in-store. The core audience includes e-commerce merchants, ISVs, and developers who need to integrate payment processing into websites or applications. The platform offers a RESTful API (v1 as described) for operations like payments, profile management, and reporting. Authentication is typically done via merchant ID and API passcode, using either HTTP basic or header-based keys, though specifics may vary. The platform is stable, with extensive documentation and SDKs (PHP, .NET, Python, etc.) to simplify integration. It supports tokenization (profiles) to store card data securely, recurring billing, and various payment flows. Integrations include popular e-commerce platforms like Shopify, Magento, and WordPress via plugins. Pricing is transaction-based with monthly fees, but no transparent public pricing is available. Rate limits are not published but are likely set to prevent abuse; typical for payment APIs, they may be based on request volume. Overall, Beanstream is positioned as a reliable, feature-rich payment solution, particularly strong for Canadian businesses, with a comprehensive API that enables deep customization and integration."
}

1/3 tests passed

{
  "overall": 48,
  "dimensions": {
    "token_efficiency": 6.0,
    "first_try_success": 3.0,
    "response_parseability": 8.0,
    "error_clarity": 4.0,
    "doc_quality": 5.0,
    "auth_simplicity": 2.0,
    "latency": 6.0,
    "consistency": 5.0
  },
  "pricing_normalized": {
    "model": "subscription",
    "cost": "variable",
    "trial": null
  },
  "issues": [
    "Website returns HTTP 406 for initial request (likely bot detection/blocking)",
    "No llms.txt file found (404), hindering agent auto-discovery",
    "Pricing not publicly disclosed - requires sales contact, slowing onboarding",
    "Merchant account required, adding friction for new users",
    "Auth process not simple (likely complex signup), no SSO/magic link evident",
    "Documentation quality mixed - API exists but no quick-start evident",
    "No trial/free tier mentioned, increase risk for first-try success"
  ],
  "recommendations": [
    "Provide a public llms.txt with concise API overview and key endpoints",
    "Publish transparent pricing tiers or at least a self-serve estimate tool",
    "Add clear getting-started guide and sample code for first API call",
    "Implement SSO (e.g., Google/GitHub) or magic link for faster agent onboarding",
    "Avoid blocking standard user-agent/bots; allow legitimate programmatic access",
    "Clarify requirements upfront (merchant account, underwriting) to set expectations"
  ]
}