AgentPay VN

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/phuocdu-agentpay-vn

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

2 read · 2 write · 0 delete · 1 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (5)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• await_settlement

  Wait for a payment request to be settled (polls on behalf of the agent). Polls every 5 seconds until status != pending or the timeout is reached (maximum 600 s). Call this after sending the QR to the payer. If the timeout expires while still pending, ask the user whether to keep waiting or cancel. Args: payment_request_id: The ``id`` returned by ``create_payment_request``. timeout_seconds: How long to wait in seconds (10–600, default 180).

• check_payment

  Check the current status of a payment request. Returns: One of: pending | settled | underpaid | expired | cancelled, along with the amount received so far. Only treat a payment as complete when status=settled.

• create_payment_request

  Create a VietQR payment request. Args: amount: Amount in VND, minimum 1 000. description: Short description for the payer (e.g. "Order #123 — 2 kg coffee"). ttl_minutes: QR validity window in minutes (5–1 440, default 60). metadata_note: Internal note from the agent (order id, conversation id, etc.) — echoed back in webhook events. Returns: id, pay_code, QR image URL, and checkout page URL. Send ``qr_image_url`` or ``checkout_url`` to the payer, then call ``await_settlement(id)`` to wait for the money to arrive.

• list_recent_payments

  List the most recently settled transactions (quick reconciliation). Args: limit: Number of transactions to return (1–50, default 10).

• register_sandbox

  Get a FREE sandbox API key (ap_test_*) instantly — call this FIRST when AGENTPAY_API_KEY is not set. No account, no human approval, no real money. The key lives 7 days; call again with the same email to renew it and keep the same sandbox org. The new key is applied to this MCP session automatically, so create_payment_request works immediately afterwards. Args: email: Optional — reusing the same email keeps the same org and its data. shop_name: Display name for the sandbox merchant.

Signals

Stars

1

Forks

0

Open issues

1

Weekly downloads

167

Last commit

Oct 20, 2026 (11 days ago)

Last release

Oct 21, 2026 (10 days ago)

Last package publish

Oct 20, 2026 (11 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.phuocdu/agentpay-vn

Version

1.1.0

Auth

API key

Packages

pypi agentpay-vn

License

MIT

Repository

github.com/phuocdu/agentpay-vn

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql