Skip to main content
Glama

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/vnpay-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server