Thailand Payments (Opn/Omise — PromptPay QR / cards / TrueMoney)

Official3 tools

by junter1989k-ai · JavaScript

Thailand payments for AI agents — PromptPay QR, cards, TrueMoney via Opn (Omise). Never holds funds.

This MCP server provides Thailand payments support for AI agents. It enables acceptance of PromptPay QR and card payments via Opn (Omise), including TrueMoney through Opn. The server is positioned as not holding funds. Tooling is available through an HTTP MCP endpoint.

🛠️ Key Features

Thailand payments: PromptPay QR
Card payments integration
TrueMoney via Opn (Omise)
“Never holds funds” behavior
HTTP transport endpoint

🚀 Use Cases

Enable AI agents to collect payments in Thailand
Support local payment methods (PromptPay QR) and card/TrueMoney flows via Opn

⚡ Developer Benefits

MCP-capable clients can connect via HTTP URL: https://mcp-th.wishpool.app/mcp
Credentials, when required, travel as HTTP headers per request
Credentials are not stored

⚠️ Limitations

Credentials handling depends on per-request HTTP headers (details referenced via a threat model)

Topics

ai-agentsmcpmcp-serveromisepaymentspromptpaythailandai-agentclaudeopnwishpool

Captured live from the server via tools/list.

create_payment_link

Create a Thailand payment link in THB via Opn Payments (formerly Omise), a major Thai payment gateway. Buyer pays with PromptPay QR (Thailand's national instant payment), credit/debit card, TrueMoney wallet, or internet banking — whatever is enabled on the merchant account. Returns a hosted payment page URL the buyer opens to pay — payment completes automatically, no confirm step. Amounts in THB baht (decimals allowed, e.g. 350.50; minimum ฿20). Bring your own Opn secret key via the x-omise-secret-key header (free skey_test_ keys from dashboard.omise.co; test keys never move real money). Money always flows buyer→Opn→merchant; this service never touches funds.

Parameters3

amount_thb	number	required	Amount in THB baht (e.g. 350.50; converted to satang internally). Minimum ฿20.
title	string	required	Short title of the payment shown to the buyer (≤255 chars)
description	string	optional	Optional longer description shown on the payment page.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_thb": {
      "type": "number",
      "minimum": 20,
      "maximum": 10000000,
      "description": "Amount in THB baht (e.g. 350.50; converted to satang internally). Minimum ฿20."
    },
    "title": {
      "type": "string",
      "description": "Short title of the payment shown to the buyer (≤255 chars)"
    },
    "description": {
      "type": "string",
      "description": "Optional longer description shown on the payment page."
    }
  },
  "required": [
    "amount_thb",
    "title"
  ]
}

query_payment_status

Check whether a Thailand payment link (created by create_payment_link) has been paid. Fetches the link from Opn (Omise) directly — a reliable pull-based alternative to webhooks. paid=true when the link is paid; last_charge_failure explains a failed attempt. Status values: PAID (paid=true — money is in) and UNPAID (keep polling ~20s; last_charge_status/failure explain a failed attempt).

Parameters1

link_id

string

required

The link_id returned by create_payment_link (link_...)

Raw schema

{
  "type": "object",
  "properties": {
    "link_id": {
      "type": "string",
      "description": "The link_id returned by create_payment_link (link_...)"
    }
  },
  "required": [
    "link_id"
  ]
}

refund_payment

Refund a paid Thailand payment (created by create_payment_link) via Opn Payments (Omise). Full refund of the remaining amount by default; pass amount for a partial refund in THB. Refunds respect the same owner policy guardrails (x-agentpay-max-amount) as payments.

Parameters2

link_id	string	required	The link_id of the paid payment (same id used by query_payment_status)
amount	number	optional	Optional partial-refund amount in THB (decimals allowed). Omit for a full refund of the remaining amount.

Raw schema

{
  "type": "object",
  "properties": {
    "link_id": {
      "type": "string",
      "description": "The link_id of the paid payment (same id used by query_payment_status)"
    },
    "amount": {
      "type": "number",
      "description": "Optional partial-refund amount in THB (decimals allowed). Omit for a full refund of the remaining amount."
    }
  },
  "required": [
    "link_id"
  ]
}

README.md3 KBView on GitHub

Thailand Payments MCP — let AI agents accept PromptPay & card payments in Thailand

Use it in 60 seconds

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

json

{
  "mcpServers": {
    "thailand-payments": {
      "type": "http",
      "url": "https://mcp-th.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/thailand-payments-mcp && cd thailand-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-th.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/thailand-payments-mcp · Part of an 8-country family: Taiwan · Japan · Korea · Indonesia · India · Brazil · Philippines

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

📱 PromptPay QR — Thailand's national instant payment rail
💳 Credit & debit cards / TrueMoney wallet / internet banking
🔍 Payment status check — pull-based, no webhook needed; no confirm step

v0.1 routes through Opn Payments (formerly Omise) Links, a major Thai payment gateway with hosted checkout. The provider registry is built for aggregation.

⚖️ Stateless translation layer: funds always flow buyer → Opn → merchant directly. This server never holds, moves, or stores funds or credentials — no database at all.

Quick start

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

Header	Value
`x-omise-secret-key`	Your Opn (Omise) secret key. `skey_test_...` = test mode (no real money, free from dashboard.omise.co); `skey_live_...` = production.

Tools

Tool	What it does
`create_payment_link`	Create a THB payment link (baht, min ฿20). Returns hosted payment URL + `link_id`.
`query_payment_status`	Check by `link_id`: UNPAID / PAID (with last-attempt failure reason).

Develop

bash

node test/serve.js      # local server (http://localhost:3218/mcp)
node test/e2e.js        # protocol + validation suite (probes real Opn auth errors)

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-th.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "thailand-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp-th.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

Thailand Payments MCP — let AI agents accept PromptPay & card payments in Thailand

Use it in 60 seconds

Or run it yourself

Quick start

Tools

Develop

Install

Remote endpoint

Related servers