Mcp Transbank

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.0-alpha.3更新於 Oct 24, 2026

MCP server for Transbank — Chile dominant card acquirer (Webpay Plus / Mall / OneClick)

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理在智利建立、提交、請款、退款並查詢 Transbank Webpay Plus、Mall 與 OneClick 卡片付款。

可以做什麼
  • 建立、提交、查詢狀態、請款或增加金額並退款 Webpay Plus 一次性跳轉付款
  • 建立、提交、查詢狀態、請款並退款可拆分至多個商家代碼的 Webpay Mall 交易
  • 發起、完成與刪除 OneClick Mall 卡片綁定，並對已存卡片授權、請款、退款與查詢
  • 透過設定在 Transbank 整合環境與正式環境之間切換
適用情境
適用於在智利以 Transbank 建置或維運電商付款，並希望助理從本機 MCP 用戶端操作 Webpay Plus、Webpay Mall 或 OneClick Mall 流程（含退款與延後請款）的情境。
執行需求
透過 npm 套件以 stdio 在本機執行（npx 或 npm install），需要 Node.js。需要商家商務代碼 TRANSBANK_COMMERCE_CODE 與 API 密鑰 TRANSBANK_API_KEY_SECRET；TRANSBANK_ENV 選擇 integration（預設）或 production。需要能連線至 Transbank 端點的網路。
安裝前請注意
API 密鑰是真實付款憑證，應避免寫入日誌或共用設定。這些工具會動用真實金流：提交、請款、增加金額、授權與退款都會作用於真實交易，正式模式下會向真實卡片扣款。請款與退款無法復原，刪除 OneClick 綁定會撤銷已存卡片。交易資料會傳送給 Transbank。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Transbank，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-transbank

MCP server for Transbank — Chile's dominant card acquirer.

Transbank 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.

Two products are covered:

  • Webpay Plus — one-shot redirect payments (buy_order + amount, user is redirected to Webpay to pay).
  • Webpay OneClick Mall — tokenized recurring / card-on-file payments that can split across multiple merchant codes (the "mall" model).

Tools (19)

ToolPurpose
webpay_create_transactionCreate a Webpay Plus transaction.
webpay_commit_transactionCommit a Webpay Plus transaction after the user has returned from the Webpay flow.
webpay_get_transaction_statusGet the current status of a Webpay Plus transaction by token.
webpay_refund_transactionRefund a committed Webpay Plus transaction.
webpay_increase_amountCapture a previously authorized Webpay Plus transaction (partial-capture / deferred-capture flow).
webpay_capture_transactionDeferred-capture for a previously authorized Webpay Plus transaction.
webpay_mall_create_transactionCreate a Webpay Mall transaction — one parent buy_order split across several seller commerce codes.
webpay_mall_commit_transactionCommit a Webpay Mall transaction after the user has returned.
webpay_mall_get_transaction_statusGet the status of a Webpay Mall transaction by token (includes per-child details).
webpay_mall_refund_transactionRefund one child seller of a Webpay Mall transaction.
webpay_mall_capture_transactionDeferred-capture for one child seller inside a Webpay Mall transaction.
oneclick_create_inscriptionStart a OneClick Mall card-enrollment flow.
oneclick_finish_inscriptionFinalize a OneClick Mall enrollment after the user has returned.
oneclick_delete_inscriptionDelete (revoke) a stored OneClick Mall card for a user.
oneclick_authorizeCharge a stored OneClick Mall card across one or more mall merchant codes.
oneclick_captureCapture a previously authorized OneClick Mall charge (deferred-capture flow).
oneclick_refundRefund a OneClick Mall charge.
oneclick_statusGet the status of a OneClick Mall transaction by parent buy_order.
oneclick_get_transaction_by_buy_orderLook up a OneClick Mall transaction by parent buy_order.

Install

bash
npm install @codespar/mcp-transbank@alpha

Environment

bash
TRANSBANK_COMMERCE_CODE="..."   # merchant commerce code (Tbk-Api-Key-Id)TRANSBANK_API_KEY_SECRET="..."  # secret key (Tbk-Api-Key-Secret)TRANSBANK_ENV="integration"     # 'integration' (default) or 'production'

Integration base URL: https://webpay3gint.transbank.cl Production base URL: https://webpay3g.transbank.cl

Authentication

Every request sends two headers:

Tbk-Api-Key-Id: <commerce_code>Tbk-Api-Key-Secret: <api_key_secret>Content-Type: application/json

The server handles headers automatically — you only configure the env vars.

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-transbank
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-transbank

Webpay Plus flow

  1. Call webpay_create_transaction with buy_order, session_id, amount, return_url.
  2. Redirect user to url?token_ws=<token>.
  3. User pays at Webpay, is redirected back to return_url.
  4. Call webpay_commit_transaction with the returned token to actually charge.

OneClick Mall flow

  1. Call oneclick_create_inscription with username, email, response_url. Redirect user to url_webpay.
  2. After user returns, call oneclick_finish_inscription. Store the returned tbk_user against your user.
  3. To charge later, call oneclick_authorize with username, tbk_user, a parent mall buy_order, and a details array (one entry per child merchant).

Enterprise

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

License

MIT

來源：packages/payments/transbank/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0-alpha.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分