Qashier MCP by usefulapi

List online payment Checkout Sessions, newest first, with status (open/complete/expired), payment status, amount in cents, refunds and receipt number. Cursor pagination: pass starting_after with the last id. GET /checkout/sessions.

{
  "type": "object",
  "properties": {
    "status": {
      "description": "Only sessions with this status.",
      "type": "string",
      "enum": [
        "open",
        "complete",
        "expired"
      ]
    },
    "limit": {
      "description": "Page size 1-100 (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "starting_after": {
      "description": "Cursor: a session id; returns the next page after it.",
      "type": "string"
    },
    "ending_before": {
      "description": "Cursor: a session id; returns the previous page before it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one Checkout Session by id: status, payment status, payment method, amount in cents, checkout url and refunds. GET /checkout/sessions/{id}.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "description": "Checkout Session id."
    }
  },
  "required": [
    "session_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: create a payment Checkout Session for ONE item and return its payment url. It charges nothing until the customer pays at that url. Amount is in cents (SGD 12.50 = 1250). POST /checkout/sessions.

{
  "type": "object",
  "properties": {
    "unit_amount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Amount to charge in cents (non-negative integer)."
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Currency code, uppercase, for example SGD, MYR, PHP."
    },
    "return_url": {
      "type": "string",
      "format": "uri",
      "description": "https URL where the customer returns after paying or cancelling."
    },
    "success_url": {
      "type": "string",
      "format": "uri",
      "description": "https URL where the customer goes when payment is complete."
    },
    "customer_email": {
      "description": "Email that receives the payment receipt.",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "expires_at": {
      "description": "Expiry as epoch seconds, 30 minutes to 24 hours from now (default 24 hours).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "idempotency_key": {
      "description": "Optional idempotency key (max 255 chars). Reuse the same key to retry safely without a duplicate.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    }
  },
  "required": [
    "unit_amount",
    "currency",
    "return_url",
    "success_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: expire an OPEN Checkout Session so the customer can no longer pay it. It fails if the session is not open. POST /checkout/sessions/{id}/expire.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "description": "Checkout Session id."
    },
    "idempotency_key": {
      "description": "Optional idempotency key (max 255 chars). Reuse the same key to retry safely without a duplicate.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    }
  },
  "required": [
    "session_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE, MONEY: refund a paid Checkout Session to the customer's original payment method. Omit amount for a full refund; amount is in cents. The refund runs asynchronously (status pending). This call has no idempotency key, so do NOT retry it: check qashier_get_checkout_session first. POST /refund.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "minLength": 1,
      "description": "Id of the completed Checkout Session to refund."
    },
    "amount": {
      "description": "Partial refund in cents. Omit to refund the full amount.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "session_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}