Skip to main content
PA

Payway

v0.1.0API Key

Gateway adquirente dominante de Argentina (ex-Prisma / Decidir). Cobros con tarjeta en dos pasos sobre los rieles que mueven el retail argentino.

6 herramientas3 env vars🇦🇷 Argentinaestable en npm

Qué puede hacer tu agente

Payway le da a tu agente 6 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_tokenTokenize sensitive card data (PAN, expiry, CVV, cardholder, document) into a single-use payment token (POST /tokens). Uses the PUBLIC apikey. Returns a token id consumed by create_payment, plus the card bin.
  • create_paymentCreate a card charge from a token produced by create_token (POST /payments). Uses the PRIVATE apikey. amount is an integer in minor units (50000 = ARS 500.00). payment_type 'single' for a normal sale, 'distributed' with sub_payments for split/marketplace.
  • get_paymentFetch a single payment by its Payway payment id (GET /payments/{id}). Uses the PRIVATE apikey.
Ejemplo de llamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_token", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-payway

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "payway": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-payway"
      ],
      "env": {
        "PAYWAY_PUBLIC_API_KEY": "<your_payway_public_api_key>",
        "PAYWAY_PRIVATE_API_KEY": "<your_payway_private_api_key>"
      }
    }
  }
}

Después de reiniciar, tu agente puede llamar cualquiera de las 6 herramientas de abajo — probá create_token primero.

Variables de entorno · 3

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

PAYWAY_PUBLIC_API_KEY
obligatoriosecret

Payway PUBLIC apikey — used only by create_token (card tokenization)

PAYWAY_PRIVATE_API_KEY
obligatoriosecret

Payway PRIVATE apikey — payments, captures, refunds and queries

PAYWAY_ENV
opcional

Environment: 'sandbox' or 'production'. Defaults to 'sandbox' (Decidir sandbox host).

Herramientas disponibles · 6

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

WRITEcreate_token
Tokenize sensitive card data (PAN, expiry, CVV, cardholder, document) into a single-use payment token (POST /tokens). Uses the PUBLIC apikey. Returns a token id consumed by create_payment, plus the card bin.
WRITEcreate_payment
Create a card charge from a token produced by create_token (POST /payments). Uses the PRIVATE apikey. amount is an integer in minor units (50000 = ARS 500.00). payment_type 'single' for a normal sale, 'distributed' with sub_payments for split/marketplace.
WRITEget_payment
Fetch a single payment by its Payway payment id (GET /payments/{id}). Uses the PRIVATE apikey.
WRITElist_payments
List payments with optional pagination and filters (GET /payments). Uses the PRIVATE apikey.
DELETErefund_payment
Refund a payment, fully or partially (POST /payments/{id}/refunds). POST with an empty body refunds the full amount; pass amount (integer minor units) for a partial refund. Uses the PRIVATE apikey.
WRITEconfirm_payment
Confirm (capture) a previously authorized payment in the two-step auth + capture flow (PUT /payments/{id}). Uses the PRIVATE apikey.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-payway` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
Payway — MCP server · 6 tools | CodeSpar