generated: '2026-08-02'
method: derived
status: candidate
source: openapi/scalapay-openapi-original.yml
notes: Scalapay publishes no hosted or remote MCP server — searched the developer portal, llms.txt, the
  MCP registries and npm on 2026-08-02 with no hit. This is a CANDIDATE tool surface derived one-to-one
  from the 20 operations in the harvested OpenAPI, so an agent builder has a grounded starting point.
  It is not a Scalapay product and must not be presented as one. Each tool inherits its real input contract
  from the parameters and requestBody of its backing operation; operationIds come from overlays/scalapay-overlay.yaml
  because the published spec declares none.
server:
  name: scalapay
  published: false
  url: null
  transport: null
auth:
  style: bearer-api-key
  header: Authorization
  note: Online operations use the merchant API key; /v1/instore and /v2/instore/paybylink operations require
    the device-scoped key (InstoreApiKeyAuth).
environments:
  sandbox: https://integration.api.scalapay.com
  production: https://api.scalapay.com
coverage:
  operations: 20
  tools: 20
  write_tools: 10
  read_tools: 10
agent_safety:
  idempotency: Six write tools accept an Idempotency-Key header (see conventions/scalapay-conventions.yml);
    a retry must reuse the same key.
  money_moving_tools:
  - capture_order
  - refund_order
  - void_order
  - create_instore_order
  - refund_instore_order
  - create_paybylink_order
  - void_paybylink_order
  - create_order
  guidance: Money-moving tools should require explicit human confirmation and should be exercised against
    integration.api.scalapay.com with the published sandbox keys first.
tools:
- name: create_instore_order
  description: Create instore order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v1/instore/orders
  operation_id: postInstoreOrders
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Instore
  read_only: false
  idempotency_key_supported: false
- name: find_instore_orders_by_reference
  description: Get instore orders by reference
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/instore/orders/references
  operation_id: getInstoreOrdersReferences
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Instore
  read_only: true
- name: get_instore_order
  description: Get an instore order
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/instore/orders/{token}
  operation_id: getInstoreOrdersByToken
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Instore
  read_only: true
- name: refund_instore_order
  description: Refund an instore order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v1/instore/orders/{token}/refund
  operation_id: postInstoreOrdersByTokenRefund
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Instore
  read_only: false
  idempotency_key_supported: false
- name: create_paybylink_order
  description: Create an offline pay-by-link order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/instore/paybylink/orders
  operation_id: postInstorePaybylinkOrders
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Instore
  read_only: false
  idempotency_key_supported: false
- name: void_paybylink_order
  description: Void an offline pay-by-link order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/instore/paybylink/orders/{token}/void
  operation_id: postInstorePaybylinkOrdersByTokenVoid
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Instore
  read_only: false
  idempotency_key_supported: false
- name: create_order
  description: Create order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/orders
  operation_id: postOrders
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: false
  idempotency_key_supported: true
- name: update_order
  description: Update order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/orders/{token}
  operation_id: postOrdersByToken
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: false
  idempotency_key_supported: true
- name: capture_order
  description: Capture order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/payments/capture
  operation_id: postPaymentsCapture
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: false
  idempotency_key_supported: true
- name: find_orders_by_reference
  description: Get orders by reference
  source_operation: openapi/scalapay-openapi-original.yml#GET /v2/payments/references
  operation_id: getPaymentsReferences
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: true
- name: get_order
  description: Get order details
  source_operation: openapi/scalapay-openapi-original.yml#GET /v2/payments/{token}
  operation_id: getPaymentsByToken
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: true
- name: delay_order
  description: Delay order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/payments/{token}/delay
  operation_id: postPaymentsByTokenDelay
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: false
  idempotency_key_supported: true
- name: refund_order
  description: Refund order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/payments/{token}/refund
  operation_id: postPaymentsByTokenRefund
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: false
  idempotency_key_supported: true
- name: void_order
  description: Void order
  source_operation: openapi/scalapay-openapi-original.yml#POST /v2/payments/{token}/void
  operation_id: postPaymentsByTokenVoid
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Orders
  read_only: false
  idempotency_key_supported: true
- name: list_disputes
  description: Get disputes
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/reporting/disputes
  operation_id: getReportingDisputes
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Reporting
  read_only: true
- name: list_reported_orders
  description: Get orders
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/reporting/orders
  operation_id: getReportingOrders
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Reporting
  read_only: true
- name: list_payouts
  description: Get payouts
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/reporting/payouts
  operation_id: getReportingPayouts
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Reporting
  read_only: true
- name: list_payout_orders
  description: Get orders from payout
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/reporting/payouts/{token}/orders
  operation_id: getReportingPayoutsByTokenOrders
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Reporting
  read_only: true
- name: list_payout_refunds
  description: Get refunds from payout
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/reporting/payouts/{token}/refunds
  operation_id: getReportingPayoutsByTokenRefunds
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Reporting
  read_only: true
- name: list_reported_refunds
  description: Get refunds
  source_operation: openapi/scalapay-openapi-original.yml#GET /v1/reporting/refunds
  operation_id: getReportingRefunds
  operation_id_source: overlays/scalapay-overlay.yaml
  category: Reporting
  read_only: true
deployment:
  mode: none
  verified: derived
  tools: 20
  checked: '2026-08-12'
  source: catalog MCP census