Mcp Payway

io.github.codesparPublished by GitHub account codesparv0.1.0Updated Oct 24, 2026

Payway (ex-Decidir) — Argentina card acquiring: tokenize, charge, capture, refund

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant tokenize cards and create, capture, refund, and query Payway (ex-Decidir) payments in Argentina.

What you can do
Wraps the Payway (formerly Decidir) card-acquiring API for Argentina. Tools cover card tokenization (create_token), charging a token as a single or split sale with installments (create_payment), fetching and listing payments, full or partial refunds, and capturing a previously authorized payment in a two-step flow. Amounts are integers in minor units, and payment_method_id identifies the card brand.
When to use it
Use it when an assistant needs to run Payway card operations for an Argentine merchant: taking a payment, capturing an authorization, issuing a refund, or looking up payment status. It is not useful for other gateways or regions.
Requirements
Runs locally over stdio, typically via npx @codespar/mcp-payway, so Node.js is needed. Requires PAYWAY_PUBLIC_API_KEY and PAYWAY_PRIVATE_API_KEY, and optionally PAYWAY_ENV set to sandbox (default) or production. Network access to the Payway or Decidir API host is required.
Before you install
The private key authorizes real charges, captures, and refunds, so production use moves money. Card data must be collected from the user or a vault; the server does not invent it. Keep PAYWAY_ENV on sandbox until ready, and treat both API keys as secrets.

Installation

In SourceWeft

  1. Open Mcp Payway in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-payway

MCP server for Payway (ex-Prisma Medios de Pago / Decidir) — Argentina's dominant card-acquiring gateway: card tokenization, one-step and two-step charges, installments (cuotas), marketplace split and refunds.

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "payway": {      "command": "npx",      "args": ["-y", "@codespar/mcp-payway"],      "env": {        "PAYWAY_PUBLIC_API_KEY": "your-public-apikey",        "PAYWAY_PRIVATE_API_KEY": "your-private-apikey",        "PAYWAY_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add payway -- npx @codespar/mcp-payway

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "payway": {      "command": "npx",      "args": ["-y", "@codespar/mcp-payway"],      "env": {        "PAYWAY_PUBLIC_API_KEY": "your-public-apikey",        "PAYWAY_PRIVATE_API_KEY": "your-private-apikey",        "PAYWAY_ENV": "sandbox"      }    }  }}

Authentication

Payway authenticates with a single raw header named apikey (not Authorization: Bearer). Two co-equal keys exist with different powers — see the table below.

The two-key model

Payway issues two co-equal API keys with different powers:

KeyHeaderMay call
PublicapikeyPOST /tokens (card tokenization only)
PrivateapikeyEverything else: payments, captures, refunds, queries

The auth header is a single raw header named apikey — not Authorization: Bearer.

Tools (6)

ToolEndpointWhat it does
create_tokenPOST /tokensTokenize card data into a single-use payment token (public key)
create_paymentPOST /paymentsCharge a token — single sale or distributed/split, with installments
get_paymentGET /payments/{id}Fetch a payment by id
list_paymentsGET /paymentsList payments (offset, pageSize, siteOperationId, merchantId)
refund_paymentPOST /payments/{id}/refundsFull refund (empty body) or partial (amount in minor units)
confirm_paymentPUT /payments/{id}Capture a previously authorized payment (two-step flow)

Environment

VariableRequiredDescription
PAYWAY_PUBLIC_API_KEYyesPublic apikey (tokenization)
PAYWAY_PRIVATE_API_KEYyesPrivate apikey (payments, refunds, queries)
PAYWAY_ENVnosandbox (default, Decidir sandbox host) or production

Base URLs: production https://ventasonline.payway.com.ar/api/v2, sandbox https://developers.decidir.com/api/v2.

Notes

  • Amounts are integers in minor units: 50000 = ARS 500.00.
  • payment_method_id identifies the card brand (1 = Visa, 31 = Mastercard, 15 = Maestro, …).
  • site_transaction_id is the merchant-side idempotency anchor — unique per sale.
  • This server never invents card data; agents must collect PAN/expiry/CVV from the user or a vault.

Enterprise

Need governance, budget limits, and audit trails for agent-driven payments on Payway? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT © CodeSpar

Source: packages/argentina/payway/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts