Skip to main content
PA

Payway

v0.1.0API Key

Gateway de adquirência dominante da Argentina (ex-Prisma / Decidir). Cobranças de cartão em duas etapas nos trilhos que movem o varejo argentino.

6 ferramentas3 env vars🇦🇷 Argentinaestável no npm

O que seu agente faz

O Payway dá ao seu agente 6 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer 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.
Exemplo de chamada
// 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

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com 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>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 6 ferramentas abaixo — teste create_token primeiro.

Variáveis de ambiente · 3

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

PAYWAY_PUBLIC_API_KEY
obrigatóriosecret

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

PAYWAY_PRIVATE_API_KEY
obrigatóriosecret

Payway PRIVATE apikey — payments, captures, refunds and queries

PAYWAY_ENV
opcional

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

Ferramentas disponíveis · 6

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

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 compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

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

Perguntas frequentes

Rode `npx -y @codespar/mcp-payway` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Payway — MCP server · 6 tools | CodeSpar