Malaysia Payments (Billplz — FPX / DuitNow QR / cards)

Official2 tools

by junter1989k-ai · JavaScript

Malaysia payments for AI agents — FPX banking, DuitNow QR, cards via Billplz. Never holds funds.

The app.wishpool/malaysia-payments-mcp is a Model Context Protocol (MCP) server for Malaysia payments. It enables AI agents to accept FPX banking, DuitNow QR, and card payments via Billplz. The server is described as never holding funds, and credentials are sent as HTTP headers per request rather than stored.

🛠️ Key Features

Supports FPX banking
Supports DuitNow QR
Supports card payments via Billplz
Does not hold funds
Uses HTTP requests for the MCP endpoint

🚀 Use Cases

Payment acceptance workflows for AI agents in Malaysia
Integrating Malaysia payment methods through an MCP-capable client

⚡ Developer Benefits

No installation beyond configuring an MCP client
Credentials (when needed) travel as HTTP headers on each request
Server URL: https://mcp-my.wishpool.app/mcp

⚠️ Limitations

Limited to the payment methods listed (FPX, DuitNow QR, and Billplz card payments)

Topics

ai-agentsbillplzfpxmalaysiamcpmcp-serverpaymentsai-agentclaudewishpool

Captured live from the server via tools/list.

create_payment_link

Create a Malaysia payment link in MYR via Billplz, a popular Malaysian payment gateway. Buyer pays with FPX online banking (every major Malaysian bank), DuitNow QR, or card — whatever is enabled on the merchant collection. Returns a hosted bill URL the buyer opens to pay — payment completes automatically, no confirm step. Amounts in MYR ringgit (decimals allowed, e.g. 49.90; minimum RM2). Billplz requires the buyer's name and email on every bill. Bring your own credentials via headers x-billplz-api-key AND x-billplz-collection-id (free from billplz-sandbox.com for testing — add x-billplz-mode: sandbox; billplz.com is production). Money always flows buyer→Billplz→merchant; this service never touches funds.

Parameters6

amount_myr	number	required	Amount in MYR ringgit (e.g. 49.90; converted to cents internally). Minimum RM2.
description	string	required	What this payment is for (shown on the bill, ≤200 chars)
customer_name	string	optional	Buyer name (required by Billplz).
customer_email	string	optional	Buyer email (required by Billplz; the bill link is also emailed there).
redirect_url	string	optional	Optional https URL to send the buyer to after payment.
provider	string	optional	Which gateway. Omit to auto-select: toyyibPay when x-toyyibpay-* headers are present, otherwise Billplz. Billplz requires customer_name+customer_email; toyyibPay does not.

Raw schema

{
  "type": "object",
  "properties": {
    "amount_myr": {
      "type": "number",
      "minimum": 2,
      "maximum": 10000000,
      "description": "Amount in MYR ringgit (e.g. 49.90; converted to cents internally). Minimum RM2."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown on the bill, ≤200 chars)"
    },
    "customer_name": {
      "type": "string",
      "description": "Buyer name (required by Billplz)."
    },
    "customer_email": {
      "type": "string",
      "description": "Buyer email (required by Billplz; the bill link is also emailed there)."
    },
    "redirect_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after payment."
    },
    "provider": {
      "type": "string",
      "enum": [
        "billplz",
        "toyyibpay"
      ],
      "description": "Which gateway. Omit to auto-select: toyyibPay when x-toyyibpay-* headers are present, otherwise Billplz. Billplz requires customer_name+customer_email; toyyibPay does not."
    }
  },
  "required": [
    "amount_myr",
    "description"
  ]
}

query_payment_status

Check whether a Malaysia bill (created by create_payment_link) has been paid. Fetches the bill from Billplz directly — a reliable pull-based alternative to webhooks. paid=true when the bill is paid (status PAID; otherwise DUE).

Parameters2

bill_id	string	required	The bill_id returned by create_payment_link (Billplz id or toyyibPay BillCode)
provider	string	optional	Omit to auto-select by credential headers.

Raw schema

{
  "type": "object",
  "properties": {
    "bill_id": {
      "type": "string",
      "description": "The bill_id returned by create_payment_link (Billplz id or toyyibPay BillCode)"
    },
    "provider": {
      "type": "string",
      "enum": [
        "billplz",
        "toyyibpay"
      ],
      "description": "Omit to auto-select by credential headers."
    }
  },
  "required": [
    "bill_id"
  ]
}

README.md4 KBView on GitHub

Malaysia Payments MCP — let AI agents accept FPX & DuitNow payments in Malaysia

Use it in 60 seconds

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

json

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

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

🏦 FPX online banking — every major Malaysian bank, the rail Malaysia actually uses
📱 DuitNow QR / cards
✉️ Bill delivery — Billplz emails the bill to the buyer automatically
🔍 Payment status check — pull-based, no webhook needed; no confirm step

v0.1 routes through Billplz, a popular Malaysian payment gateway with hosted bill pages. The provider registry is built for aggregation.

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

Quick start

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

Header	Value
`x-billplz-api-key`	Your Billplz API key (dashboard → Settings → Keys).
`x-billplz-collection-id`	The collection to bill under (create one in the dashboard).
`x-billplz-mode`	`sandbox` for billplz-sandbox.com test accounts (no real money); omit for production.

Tools

Tool	What it does
`create_payment_link`	Create a MYR bill (ringgit, min RM2; buyer name+email required). Returns hosted bill URL + `bill_id`.
`query_payment_status`	Check by `bill_id`: DUE / PAID.

Develop

bash

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

Zero runtime dependencies; Node ≥ 18. MIT license.

Install

Tools (2)

create_payment_linkquery_payment_status

Remote endpoint

Streamable HTTP

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

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json