Japan Payments (KOMOJU — konbini / cards / PayPay)

Official3 tools

by junter1989k-ai · JavaScript

Japan payments for AI agents — konbini コンビニ, card, PayPay via KOMOJU. Stateless, never holds funds.

Japan payments for AI agents, providing a way for MCP clients to use payment functionality in Japan. The service supports konbini コンビニ, card, and PayPay via KOMOJU. It is stateless and does not hold funds.

🛠️ Key Features

Japan payment support for AI agents
Payment methods: konbini コンビニ, card, PayPay via KOMOJU
Stateless design: does not hold funds
Uses HTTP requests for configuration and access

🚀 Use Cases

Generating payment links for AI agents in Japan
Handling payments for workflows that need konbini コンビニ, card, or PayPay via KOMOJU

⚡ Developer Benefits

No install required; connect via MCP client config using an HTTP transport
Credentials, when needed, travel as HTTP headers on each request and are not stored

⚠️ Limitations

Stateless operation means the server does not hold funds and relies on per-request credential delivery

Topics

ai-agentsjapankomojukonbinimcpmcp-serverpaymentsai-agentclaudewishpool

Captured live from the server via tools/list.

create_payment_link

Create a Japan payment link in JPY. Aggregates two Japanese gateways: KOMOJU (default — konbini コンビニ決済 convenience store, credit card, PayPay, bank transfer and more) and PayPay direct (Open Payment API ORDER_QR; send x-paypay-api-key/-api-secret/-merchant-id headers and it is auto-selected, or set provider). Returns a hosted checkout URL the buyer opens to pay. Bring your own KOMOJU secret key via the x-komoju-secret-key header (free test-mode keys from the KOMOJU dashboard; sk_test_ keys are safe, no real money moves). Money always flows buyer→KOMOJU→merchant; this service never touches funds.

Parameters7

amount	integer	required	Amount in JPY (integer, e.g. 1000 = ¥1,000)
description	string	required	What this payment is for (kept in session metadata, ≤200 chars)
payment_types	array	optional	Restrict payment methods shown to the buyer (e.g. ["konbini"] for convenience-store only). Omit to show every method enabled on the merchant account.
return_url	string	optional	Optional https URL to redirect the buyer to after payment completes.
customer_email	string	optional	Buyer email. Strongly recommended for konbini (KOMOJU emails the store payment code to the buyer).
external_order_num	string	optional	Your unique order reference (≤30 chars, alphanumeric). Auto-generated if omitted.
provider	string	optional	Which gateway. Omit to auto-select: PayPay when x-paypay-* headers are present, otherwise KOMOJU. payment_types applies to KOMOJU only.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000,
      "description": "Amount in JPY (integer, e.g. 1000 = ¥1,000)"
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (kept in session metadata, ≤200 chars)"
    },
    "payment_types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "konbini",
          "credit_card",
          "paypay",
          "bank_transfer",
          "pay_easy",
          "linepay",
          "merpay",
          "aupay",
          "rakutenpay"
        ]
      },
      "description": "Restrict payment methods shown to the buyer (e.g. [\"konbini\"] for convenience-store only). Omit to show every method enabled on the merchant account."
    },
    "return_url": {
      "type": "string",
      "description": "Optional https URL to redirect the buyer to after payment completes."
    },
    "customer_email": {
      "type": "string",
      "description": "Buyer email. Strongly recommended for konbini (KOMOJU emails the store payment code to the buyer)."
    },
    "external_order_num": {
      "type": "string",
      "description": "Your unique order reference (≤30 chars, alphanumeric). Auto-generated if omitted."
    },
    "provider": {
      "type": "string",
      "enum": [
        "komoju",
        "paypay"
      ],
      "description": "Which gateway. Omit to auto-select: PayPay when x-paypay-* headers are present, otherwise KOMOJU. payment_types applies to KOMOJU only."
    }
  },
  "required": [
    "amount",
    "description"
  ]
}

query_payment_status

Check whether a Japan payment (created by create_payment_link) has been paid. Fetches the KOMOJU session directly — a reliable pull-based alternative to webhooks. Status values: PENDING (buyer has not completed checkout — keep polling ~20s), COMPLETE (checkout finished; paid=true once payment_status is captured/authorized — konbini shows captured only after the store payment), CANCELLED, EXPIRED.

Parameters2

session_id	string	required	The session_id returned by create_payment_link
provider	string	optional	Omit to auto-select by credential headers.

Raw schema

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id returned by create_payment_link"
    },
    "provider": {
      "type": "string",
      "enum": [
        "komoju",
        "paypay"
      ],
      "description": "Omit to auto-select by credential headers."
    }
  },
  "required": [
    "session_id"
  ]
}

refund_payment

Refund a paid Japan payment (created by create_payment_link; KOMOJU only for now). Full refund by default; pass amount for a partial refund. Refunds respect the same owner policy guardrails (x-agentpay-max-amount) as payments — the amount is checked before anything is sent to the gateway.

Parameters3

session_id	string	required	The session_id of the paid payment (same id used by query_payment_status)
amount	integer	optional	Optional partial-refund amount in JPY (integer). Omit for a full refund.
provider	string	optional	Omit to auto-select by credential headers. Refunds are currently supported on KOMOJU.

Raw schema

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id of the paid payment (same id used by query_payment_status)"
    },
    "amount": {
      "type": "integer",
      "description": "Optional partial-refund amount in JPY (integer). Omit for a full refund."
    },
    "provider": {
      "type": "string",
      "enum": [
        "komoju",
        "paypay"
      ],
      "description": "Omit to auto-select by credential headers. Refunds are currently supported on KOMOJU."
    }
  },
  "required": [
    "session_id"
  ]
}

README.md5 KBView on GitHub

Japan Payments MCP — 日本で AI エージェントが決済リンクを作れる MCP サーバー

Use it in 60 seconds

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

json

{
  "mcpServers": {
    "japan-payments": {
      "type": "http",
      "url": "https://mcp-jp.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/japan-payments-mcp && cd japan-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-jp.wishpool.app/mcp · Listed on the official MCP Registry as app.wishpool/japan-payments-mcp · Sister servers: Taiwan · Korea · Indonesia · India

English below. / 日本語は下記の通り。

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

🏪 コンビニ決済 (konbini) — the payment rail Japan actually uses; buyer gets a code and pays at the convenience store
💳 Credit card / PayPay / bank transfer / Pay-easy / LINE Pay / Merpay / au PAY / Rakuten Pay
🔍 Payment status check — pull-based, no webhook needed

v0.1 routes through KOMOJU, a Japanese payment gateway with a hosted checkout page. The provider registry is built for aggregation — more Japanese gateways join behind the same tools.

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

Why this exists

Japanese payment rails — especially konbini — are built for humans clicking through web pages. An AI agent has no agent-ready API for "let my customer pay at 7-Eleven". This MCP server translates that flow into tools an agent can call.

Quick start

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

Add the server URL in any remote-MCP client (Claude Desktop / Claude Code / Cursor…), then send your KOMOJU key as a header on each request:

Header	Value
`x-komoju-secret-key`	Your KOMOJU secret key. `sk_test_...` = test mode (no real money, free from the KOMOJU dashboard after switching to Test mode); `sk_live_...` = production.

No public demo key exists for KOMOJU, so bring your own — a test-mode key takes a minute to get and never moves real money.

Tools

Tool	What it does
`create_payment_link`	Create a JPY hosted-checkout link (konbini / card / PayPay / …). Returns the URL the buyer opens.
`query_payment_status`	Check whether a session has been paid (`captured` / `authorized`).

Develop

bash

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

Zero runtime dependencies; Node ≥ 18.

English summary

Remote MCP server for Japan payments: konbini (コンビニ決済), credit cards, PayPay, bank transfer and more, via KOMOJU's hosted checkout. Bring-your-own credentials (x-komoju-secret-key), stateless, never touches funds, MIT-licensed, zero dependencies. Endpoint: https://mcp-jp.wishpool.app/mcp.

Part of a family: Taiwan Payments MCP covers Taiwan (ECPay 綠界 / NewebPay 藍新 + government e-invoices 電子發票) · Korea Payments MCP covers Korea (Toss Payments — cards / KakaoPay·NaverPay / 가상계좌) · Indonesia Payments MCP covers Indonesia (Midtrans Snap — GoPay / QRIS / Alfamart) · India Payments MCP covers India (Razorpay Payment Links — UPI / cards).

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

Japan Payments MCP — 日本で AI エージェントが決済リンクを作れる MCP サーバー

Use it in 60 seconds

Or run it yourself

Why this exists

Quick start

Tools

Develop

English summary

Install

Remote endpoint

Related servers