Vietnam Payments (MoMo — wallet QR / ATM / cards)

Official3 tools

by junter1989k-ai · JavaScript

Vietnam payments for AI agents — MoMo wallet QR, ATM, cards. Zero-setup sandbox. Never holds funds.

The app.wishpool/vietnam-payments-mcp MCP server provides “Vietnam payments for AI agents,” focused on MoMo wallet QR, ATM, and cards. It is described as a “zero-setup sandbox” and states that it “never holds funds.” The server exposes 3 tools, and is intended to be used via an MCP client configuration over HTTP.

🛠️ Key Features

Vietnam payments via AI agents
MoMo wallet QR, ATM, and cards
Zero-setup sandbox
Never holds funds
Tool count: 3

🚀 Use Cases

Enabling AI agents to accept MoMo payments in Vietnam
Integrating payment methods (MoMo QR, ATM, cards) through an MCP-capable agent

⚡ Developer Benefits

HTTP-based MCP server endpoint: https://mcp-vn.wishpool.app/mcp
“Nothing to install”
Credentials, when needed, travel as HTTP headers per request and “are never stored” (see the referenced trust/threat model)

⚠️ Limitations

The included excerpt truncates after “Or run it”, so local/offline operation details are not provided here.

Topics

ai-agentsmcpmcp-servermomopaymentsvietnamai-agentclaudewishpool

Captured live from the server via tools/list.

create_payment_link

Create a Vietnam payment link in VND. Aggregates two Vietnamese gateways: MoMo (default; the biggest e-wallet, zero-setup sandbox demo with no headers) and VNPay (bank cards/QR across most Vietnamese banks; send x-vnpay-tmn-code + x-vnpay-hash-secret headers and it is auto-selected, or set provider). Via MoMo, Vietnam's biggest e-wallet. Buyer pays with the MoMo wallet (QR), ATM card, or credit card on MoMo's hosted payment page — payment completes automatically, no confirm step. Amounts in VND dong (integer, e.g. 150000 = 150,000₫; min 1,000 / max 50,000,000). Zero-setup demo: with NO credential headers, requests run against MoMo's public sandbox (test money only, safe to try immediately). For real usage bring your own MoMo business credentials via headers x-momo-partner-code + x-momo-access-key + x-momo-secret-key (from business.momo.vn). Money always flows buyer→MoMo→merchant; this service never touches funds.

Parameters5

amount	integer	required	Amount in VND (integer, e.g. 150000 = 150,000₫). MoMo limits: 1,000–50,000,000.
order_info	string	required	What this payment is for (shown to the buyer, ≤200 chars)
redirect_url	string	optional	Optional https URL MoMo redirects the buyer to after payment.
order_id	string	optional	Your unique order reference (≤50 chars, letters/digits/-/_). Auto-generated if omitted. Needed to query status.
provider	string	optional	Which gateway to use. Omit to auto-select: VNPay when x-vnpay-* headers are present, otherwise MoMo.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "integer",
      "minimum": 1000,
      "maximum": 50000000,
      "description": "Amount in VND (integer, e.g. 150000 = 150,000₫). MoMo limits: 1,000–50,000,000."
    },
    "order_info": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤200 chars)"
    },
    "redirect_url": {
      "type": "string",
      "description": "Optional https URL MoMo redirects the buyer to after payment."
    },
    "order_id": {
      "type": "string",
      "description": "Your unique order reference (≤50 chars, letters/digits/-/_). Auto-generated if omitted. Needed to query status."
    },
    "provider": {
      "type": "string",
      "enum": [
        "momo",
        "vnpay"
      ],
      "description": "Which gateway to use. Omit to auto-select: VNPay when x-vnpay-* headers are present, otherwise MoMo."
    }
  },
  "required": [
    "amount",
    "order_info"
  ]
}

query_payment_status

Check whether a Vietnam payment (created by create_payment_link) has been paid. Queries MoMo directly — a reliable pull-based alternative to webhooks. paid=true when resultCode 0 (status PAID); 1000 = PENDING (buyer has not finished).

Parameters3

order_id	string	required	The order_id returned by create_payment_link
transaction_date	string	optional	VNPay only, usually NOT needed (auto-derived from order_id). Pass yyyyMMddHHmmss (GMT+7) only if you supplied a custom order_id at creation.
provider	string	optional	Omit to auto-select by credential headers.

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The order_id returned by create_payment_link"
    },
    "transaction_date": {
      "type": "string",
      "description": "VNPay only, usually NOT needed (auto-derived from order_id). Pass yyyyMMddHHmmss (GMT+7) only if you supplied a custom order_id at creation."
    },
    "provider": {
      "type": "string",
      "enum": [
        "momo",
        "vnpay"
      ],
      "description": "Omit to auto-select by credential headers."
    }
  },
  "required": [
    "order_id"
  ]
}

refund_payment

Refund a paid Vietnam MoMo payment (created by create_payment_link; MoMo only for now). MoMo refunds always specify the amount in VND — full or partial. Identify the original payment by order_id (this looks up its MoMo transId and, when amount is omitted, the full paid amount) OR pass trans_id + amount directly (trans_id comes from query_payment_status). Refunds respect the same owner policy guardrail (x-agentpay-max-amount) as payments — the refund amount is checked before anything is sent to MoMo.

Parameters4

order_id	string	optional	The order_id of the paid payment (from create_payment_link). Used to look up the MoMo transId; if amount is omitted, the full paid amount is refunded.
trans_id	string	optional	The MoMo transId of the original payment (from query_payment_status → trans_id). Alternative to order_id; requires amount.
amount	integer	optional	Refund amount in VND (integer). Required with trans_id; with order_id, omit for a full refund or set it for a partial refund.
provider	string	optional	Omit to auto-select by credential headers. Refunds are currently supported on MoMo only.

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The order_id of the paid payment (from create_payment_link). Used to look up the MoMo transId; if amount is omitted, the full paid amount is refunded."
    },
    "trans_id": {
      "type": "string",
      "description": "The MoMo transId of the original payment (from query_payment_status → trans_id). Alternative to order_id; requires amount."
    },
    "amount": {
      "type": "integer",
      "description": "Refund amount in VND (integer). Required with trans_id; with order_id, omit for a full refund or set it for a partial refund."
    },
    "provider": {
      "type": "string",
      "enum": [
        "momo",
        "vnpay"
      ],
      "description": "Omit to auto-select by credential headers. Refunds are currently supported on MoMo only."
    }
  }
}

README.md4 KBView on GitHub

Vietnam Payments MCP — let AI agents accept MoMo payments in Vietnam

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "vietnam-payments": {
      "type": "http",
      "url": "https://mcp-vn.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/vietnam-payments-mcp && cd vietnam-payments-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Live · MCP endpoint: https://mcp-vn.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/vietnam-payments-mcp · Part of a 10-country family: Taiwan · Japan · Korea · Indonesia · India · Brazil · Philippines · Thailand · Malaysia

A remote MCP server that lets any AI agent (Claude, ChatGPT, Cursor…) accept payments in Vietnam:

📱 MoMo wallet QR — the biggest e-wallet in Vietnam
💳 ATM cards / credit cards on the MoMo hosted page
🎁 Zero-setup demo — no credentials needed to try it (public MoMo sandbox, test money only)
🔍 Payment status check — pull-based, no webhook needed; no confirm step

v0.2 aggregates two Vietnamese gateways: MoMo (default; zero-setup sandbox demo) and VNPay (signed HMAC-SHA512 redirect URLs; send x-vnpay-tmn-code + x-vnpay-hash-secret and it is auto-selected).

⚖️ Stateless translation layer: funds always flow buyer → MoMo → merchant directly. This server never holds, moves, or stores funds or credentials — no database at all. Requests are signed per-call with HMAC-SHA256 in memory.

Quick start

MCP endpoint: https://mcp-vn.wishpool.app/mcp (Streamable HTTP, stateless JSON-RPC)

Try it with no headers at all — the public MoMo sandbox demo works immediately. For real payments:

Header	Value
`x-momo-partner-code` / `x-momo-access-key` / `x-momo-secret-key`	Your MoMo business credentials (from business.momo.vn).
`x-momo-mode`	`test` to use the MoMo test host with your own sandbox merchant (optional; default production).

Tools

Tool	What it does
`create_payment_link`	Create a VND payment (1,000–50,000,000₫). Returns the MoMo hosted `payment_url` + `order_id`.
`query_payment_status`	Check by `order_id`: PAID / PENDING / FAILED.
`refund_payment`	Refund a paid MoMo payment (full or partial). By `order_id` (looks up the transId; full refund if `amount` omitted) or `trans_id` + `amount`. MoMo only.

Develop

bash

node test/serve.js      # local server (http://localhost:3220/mcp)
node test/e2e.js        # e2e incl. a REAL sandbox create+query against MoMo test host

Zero runtime dependencies; Node ≥ 18. MIT license.

Install

Tools (3)

create_payment_linkquery_payment_statusrefund_payment

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp-vn.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "vietnam-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-vn.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_payment_link

query_payment_status

refund_payment

Vietnam Payments MCP — let AI agents accept MoMo payments in Vietnam

Use it in 60 seconds

Or run it yourself

Quick start

Tools

Develop

Install

Remote endpoint

Related servers