{"_id":"@codespar/mcp-transbank","_rev":"5-292c21ecad4dc3a5c49664d2d523c9ed","name":"@codespar/mcp-transbank","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-transbank","version":"0.1.0","keywords":["mcp","transbank","webpay","oneclick","payments","chile","latam","acquirer"],"license":"MIT","_id":"@codespar/mcp-transbank@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-transbank":"dist/index.js"},"dist":{"shasum":"d6f74d5f6f3661b43b769da28148a2a564664dad","tarball":"https://registry.npmjs.org/@codespar/mcp-transbank/-/mcp-transbank-0.1.0.tgz","fileCount":6,"integrity":"sha512-243Xt8B1dff5OjFUjdRc+dm3EGdSBPXFJ98+Z9mqrD3m/frx0mD5ClNWYhHuHENVse13dtq9y8YyAR+nuk0r3w==","signatures":[{"sig":"MEUCIFqVpcrwrdHGd04/LudcqOBOTEOgsLr+5DTcURw5LZQVAiEAoal2TU5f+3r1sbOY2QRmlj3dfFe0pwnjjLtVbhToD7E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43151},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c00634d3cb84e72668261708b2a55e90bf9ae780","mcpName":"io.github.codespar/mcp-transbank","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Transbank — Chile's dominant card acquirer (Webpay Plus + Webpay OneClick Mall)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-transbank_0.1.0_1776992553410_0.41286728653289284","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-transbank","version":"0.2.0-alpha.1","keywords":["mcp","transbank","webpay","oneclick","payments","chile","latam","acquirer"],"license":"MIT","_id":"@codespar/mcp-transbank@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-transbank":"dist/index.js"},"dist":{"shasum":"c4fcc94d2a750212c0d3138fa6ef16fa54b14696","tarball":"https://registry.npmjs.org/@codespar/mcp-transbank/-/mcp-transbank-0.2.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-3+RxB9RZLBDpU4PVTFLjph7qh7K/KuEw8jO1Mhmg1NOxcGKC8AkjDfUQqgaZ7AUCbeHSyjURVQ+mxvOtCETKUQ==","signatures":[{"sig":"MEUCIEbuP6PdNwLTcb5v+Iaf4lv/Z+t1RdWOWRs+bmyQnxdfAiEAjAOXHro9wHdXd5SbnExlW4h2uHrzovN7rGU3L1R/xMU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61091},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"aa155cfd90298f7233644389f945286db9d20fe4","mcpName":"io.github.codespar/mcp-transbank","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Transbank — Chile's dominant card acquirer (Webpay Plus + Webpay Mall + Webpay OneClick Mall)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-transbank_0.2.0-alpha.1_1777065412991_0.73739331035074","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-transbank","version":"0.2.0-alpha.2","keywords":["mcp","transbank","webpay","oneclick","payments","chile","latam","acquirer"],"license":"MIT","_id":"@codespar/mcp-transbank@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-transbank":"dist/index.js"},"dist":{"shasum":"1a58c4ee3262a485e4510daddd2aec12b925fc4b","tarball":"https://registry.npmjs.org/@codespar/mcp-transbank/-/mcp-transbank-0.2.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-vYyhFMtlst0KFk3vSIq1RiRWphGsmPZRgldXBEMBbj5Y8iIXawNDxeX6l6sb7R+PD55v6ABZhoNI+g/Q+U5Xtg==","signatures":[{"sig":"MEUCICizksTsFI5v+TPk7Xm0VQQun32sD6dAC1XUabmoH4mPAiEAmgAxvHfosz6HbbZI7qQpifHb4NVQhCGvKL1jks7f1PQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62082},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-transbank","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Transbank — Chile's dominant card acquirer (Webpay Plus + Webpay Mall + Webpay OneClick Mall)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-transbank_0.2.0-alpha.2_1777123276149_0.39707633723867053","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-transbank","version":"0.2.0-alpha.3","description":"MCP server for Transbank — Chile's dominant card acquirer (Webpay Plus + Webpay Mall + Webpay OneClick Mall)","type":"module","main":"./dist/index.js","bin":{"mcp-transbank":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","transbank","webpay","oneclick","payments","chile","latam","acquirer"],"mcpName":"io.github.codespar/mcp-transbank","_id":"@codespar/mcp-transbank@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-amPoDzRq3asLJcPvL/uakJlKBSsYufnXW+Q/CFv3i8SPvml6Jsz1I8Q3WgB3hMD8e9kBmydN2SavmSzzkZ7Wew==","shasum":"585f3fac30ad1e99fe47bf991c984425e253d9bb","tarball":"https://registry.npmjs.org/@codespar/mcp-transbank/-/mcp-transbank-0.2.0-alpha.3.tgz","fileCount":6,"unpackedSize":63570,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCrSOQo/+CjFoyQnu+KasaIKbHzhZem9ggLq+w1vsq31wIhAPPliQ2D4e5tvYKRiwmjZK1rwczQU1WmQOJVM4Hnbrvu"}]},"_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-transbank_0.2.0-alpha.3_1782153982304_0.7215690898548857"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:02:33.335Z","modified":"2026-06-22T18:46:22.606Z","0.1.0":"2026-04-24T01:02:33.576Z","0.2.0-alpha.1":"2026-04-24T21:16:53.147Z","0.2.0-alpha.2":"2026-04-25T13:21:16.318Z","0.2.0-alpha.3":"2026-06-22T18:46:22.460Z"},"license":"MIT","keywords":["mcp","transbank","webpay","oneclick","payments","chile","latam","acquirer"],"description":"MCP server for Transbank — Chile's dominant card acquirer (Webpay Plus + Webpay Mall + Webpay OneClick Mall)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-transbank\n\nMCP server for [Transbank](https://www.transbankdevelopers.cl) — Chile's dominant card acquirer.\n\nTransbank is effectively default for Chilean commerce (state-origin roots, owned by a consortium of Chilean banks). Shipping this server is a prerequisite for any \"CodeSpar covers LatAm\" claim that includes Chile.\n\nTwo products are covered:\n\n- **Webpay Plus** — one-shot redirect payments (`buy_order` + `amount`, user is redirected to Webpay to pay).\n- **Webpay OneClick Mall** — tokenized recurring / card-on-file payments that can split across multiple merchant codes (the \"mall\" model).\n\n## Tools (19)\n\n| Tool | Purpose |\n|---|---|\n| `webpay_create_transaction` | Create a Webpay Plus transaction. |\n| `webpay_commit_transaction` | Commit a Webpay Plus transaction after the user has returned from the Webpay flow. |\n| `webpay_get_transaction_status` | Get the current status of a Webpay Plus transaction by token. |\n| `webpay_refund_transaction` | Refund a committed Webpay Plus transaction. |\n| `webpay_increase_amount` | Capture a previously authorized Webpay Plus transaction (partial-capture / deferred-capture flow). |\n| `webpay_capture_transaction` | Deferred-capture for a previously authorized Webpay Plus transaction. |\n| `webpay_mall_create_transaction` | Create a Webpay Mall transaction — one parent buy_order split across several seller commerce codes. |\n| `webpay_mall_commit_transaction` | Commit a Webpay Mall transaction after the user has returned. |\n| `webpay_mall_get_transaction_status` | Get the status of a Webpay Mall transaction by token (includes per-child details). |\n| `webpay_mall_refund_transaction` | Refund one child seller of a Webpay Mall transaction. |\n| `webpay_mall_capture_transaction` | Deferred-capture for one child seller inside a Webpay Mall transaction. |\n| `oneclick_create_inscription` | Start a OneClick Mall card-enrollment flow. |\n| `oneclick_finish_inscription` | Finalize a OneClick Mall enrollment after the user has returned. |\n| `oneclick_delete_inscription` | Delete (revoke) a stored OneClick Mall card for a user. |\n| `oneclick_authorize` | Charge a stored OneClick Mall card across one or more mall merchant codes. |\n| `oneclick_capture` | Capture a previously authorized OneClick Mall charge (deferred-capture flow). |\n| `oneclick_refund` | Refund a OneClick Mall charge. |\n| `oneclick_status` | Get the status of a OneClick Mall transaction by parent buy_order. |\n| `oneclick_get_transaction_by_buy_order` | Look up a OneClick Mall transaction by parent buy_order. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-transbank@alpha\n```\n\n## Environment\n\n```bash\nTRANSBANK_COMMERCE_CODE=\"...\"   # merchant commerce code (Tbk-Api-Key-Id)\nTRANSBANK_API_KEY_SECRET=\"...\"  # secret key (Tbk-Api-Key-Secret)\nTRANSBANK_ENV=\"integration\"     # 'integration' (default) or 'production'\n```\n\nIntegration base URL: `https://webpay3gint.transbank.cl`\nProduction base URL: `https://webpay3g.transbank.cl`\n\n## Authentication\n\nEvery request sends two headers:\n\n```\nTbk-Api-Key-Id: <commerce_code>\nTbk-Api-Key-Secret: <api_key_secret>\nContent-Type: application/json\n```\n\nThe server handles headers automatically — you only configure the env vars.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-transbank\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-transbank\n```\n\n## Webpay Plus flow\n\n1. Call `webpay_create_transaction` with `buy_order`, `session_id`, `amount`, `return_url`.\n2. Redirect user to `url?token_ws=<token>`.\n3. User pays at Webpay, is redirected back to `return_url`.\n4. Call `webpay_commit_transaction` with the returned token to actually charge.\n\n## OneClick Mall flow\n\n1. Call `oneclick_create_inscription` with `username`, `email`, `response_url`. Redirect user to `url_webpay`.\n2. After user returns, call `oneclick_finish_inscription`. Store the returned `tbk_user` against your user.\n3. To charge later, call `oneclick_authorize` with `username`, `tbk_user`, a parent mall `buy_order`, and a `details` array (one entry per child merchant).\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}