vnpay-mcp

MCP server for VNPay payment gateway (Vietnam). Supports payment URL generation, transaction queries, refunds, tokenized payments, and IPN verification with HMAC-SHA512 signing.

Tools (8)

Tool	Description
`create_payment_url`	Generate a VNPay payment URL
`query_transaction`	Query transaction status
`refund`	Refund a transaction
`get_bank_list`	Get supported bank list
`create_token`	Create a card token
`pay_with_token`	Pay using stored token
`query_token`	Query token information
`verify_ipn`	Verify IPN callback signature

Quick Start

{
  "mcpServers": {
    "vnpay": {
      "command": "npx",
      "args": ["-y", "@theyahia/vnpay-mcp"],
      "env": {
        "VNPAY_TMN_CODE": "<YOUR_TMN_CODE>",
        "VNPAY_HASH_SECRET": "<YOUR_HASH_SECRET>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`VNPAY_TMN_CODE`	Yes	Terminal code from VNPay
`VNPAY_HASH_SECRET`	Yes	Hash secret for HMAC-SHA512 signing
`VNPAY_PRODUCTION`	No	Set to "true" for production

Demo Prompts

"Create a VNPay payment URL for 100,000 VND"
"Query transaction status for order vnp-123"
"Get list of supported Vietnamese banks"
"Verify this IPN callback: vnp_TxnRef=..."

License

MIT

@theyahia/vnpay-mcp

Quick Install