{"_id":"@codespar/mcp-payway","name":"@codespar/mcp-payway","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-payway","version":"0.1.0","description":"MCP server for Payway (ex-Prisma/Decidir) — Argentina's dominant card-acquiring gateway: tokenize, charge, capture, refund","type":"module","main":"./dist/index.js","bin":{"mcp-payway":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","payway","decidir","prisma-medios-de-pago","payments","card-acquiring","argentina"],"mcpName":"io.github.codespar/mcp-payway","_id":"@codespar/mcp-payway@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-B2cx5bItPqekBKsRCAx3qJYYukt/6y6AAxgyyo5cWXxQ47gmeTtwhYLpHXS+trDPr1Z6UpLHJCh514VZ4SYDmg==","shasum":"3cfdccd4fce5e1008af65b56f57869446b2dde14","tarball":"https://registry.npmjs.org/@codespar/mcp-payway/-/mcp-payway-0.1.0.tgz","fileCount":4,"unpackedSize":20555,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICCEqEVokjBjWx0PRjDqiGJ5mxMAT/Bx8nJR/8WWTZA3AiEAgeLkpyIcEfGA4u5ER0VOOYpZUDOgDRtORYdEno25nfc="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-payway_0.1.0_1783129548351_0.9812264457148399"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:45:48.158Z","0.1.0":"2026-07-04T01:45:48.505Z","modified":"2026-07-04T01:45:48.735Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Payway (ex-Prisma/Decidir) — Argentina's dominant card-acquiring gateway: tokenize, charge, capture, refund","keywords":["mcp","payway","decidir","prisma-medios-de-pago","payments","card-acquiring","argentina"],"license":"MIT","readme":"# @codespar/mcp-payway\n\n> 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.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-payway)](https://www.npmjs.com/package/@codespar/mcp-payway)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"payway\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-payway\"],\n      \"env\": {\n        \"PAYWAY_PUBLIC_API_KEY\": \"your-public-apikey\",\n        \"PAYWAY_PRIVATE_API_KEY\": \"your-private-apikey\",\n        \"PAYWAY_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add payway -- npx @codespar/mcp-payway\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"payway\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-payway\"],\n      \"env\": {\n        \"PAYWAY_PUBLIC_API_KEY\": \"your-public-apikey\",\n        \"PAYWAY_PRIVATE_API_KEY\": \"your-private-apikey\",\n        \"PAYWAY_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n## Authentication\n\nPayway authenticates with a single raw header named `apikey` (**not** `Authorization: Bearer`). Two co-equal keys exist with different powers — see the table below.\n\n## The two-key model\n\nPayway issues two co-equal API keys with different powers:\n\n| Key | Header | May call |\n|---|---|---|\n| **Public** | `apikey` | `POST /tokens` (card tokenization only) |\n| **Private** | `apikey` | Everything else: payments, captures, refunds, queries |\n\nThe auth header is a single raw header named `apikey` — **not** `Authorization: Bearer`.\n\n## Tools (6)\n\n| Tool | Endpoint | What it does |\n|---|---|---|\n| `create_token` | `POST /tokens` | Tokenize card data into a single-use payment token (public key) |\n| `create_payment` | `POST /payments` | Charge a token — single sale or distributed/split, with installments |\n| `get_payment` | `GET /payments/{id}` | Fetch a payment by id |\n| `list_payments` | `GET /payments` | List payments (offset, pageSize, siteOperationId, merchantId) |\n| `refund_payment` | `POST /payments/{id}/refunds` | Full refund (empty body) or partial (`amount` in minor units) |\n| `confirm_payment` | `PUT /payments/{id}` | Capture a previously authorized payment (two-step flow) |\n\n## Environment\n\n| Variable | Required | Description |\n|---|---|---|\n| `PAYWAY_PUBLIC_API_KEY` | yes | Public apikey (tokenization) |\n| `PAYWAY_PRIVATE_API_KEY` | yes | Private apikey (payments, refunds, queries) |\n| `PAYWAY_ENV` | no | `sandbox` (default, Decidir sandbox host) or `production` |\n\nBase URLs: production `https://ventasonline.payway.com.ar/api/v2`, sandbox `https://developers.decidir.com/api/v2`.\n\n## Notes\n\n- Amounts are integers in **minor units**: `50000` = ARS 500.00.\n- `payment_method_id` identifies the card brand (1 = Visa, 31 = Mastercard, 15 = Maestro, …).\n- `site_transaction_id` is the merchant-side idempotency anchor — unique per sale.\n- This server never invents card data; agents must collect PAN/expiry/CVV from the user or a vault.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent-driven payments on Payway? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds a policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT © CodeSpar\n","readmeFilename":"README.md","_rev":"1-e7e0776d8af5c1302a94f6f505d44155"}