# bepaid-mcp

MCP server for bePaid payment gateway (Belarus). Supports payments, captures, voids, refunds, card tokenization, and subscriptions via HTTP Basic auth.

## Tools (8)

| Tool | Description |
|---|---|
| `create_payment` | Create a payment checkout |
| `get_payment` | Get transaction details by UID |
| `capture_payment` | Capture an authorized payment |
| `void_payment` | Void an authorized payment |
| `refund_payment` | Refund a captured payment |
| `tokenize_card` | Create card tokenization checkout |
| `charge_token` | Charge a tokenized card |
| `create_subscription` | Create a recurring subscription |

## Quick Start

```json
{
  "mcpServers": {
    "bepaid": {
      "command": "npx",
      "args": ["-y", "@theyahia/bepaid-mcp"],
      "env": {
        "BEPAID_SHOP_ID": "<YOUR_SHOP_ID>",
        "BEPAID_SECRET_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `BEPAID_SHOP_ID` | Yes | Shop ID from bePaid dashboard |
| `BEPAID_SECRET_KEY` | Yes | Secret key from bePaid dashboard |

## Demo Prompts

- "Create a payment for 50 BYN for an online course"
- "Check transaction status for tx-abc123"
- "Refund 20 BYN from transaction tx-xyz789"
- "Tokenize a card for future payments"
- "Set up a monthly subscription of 30 BYN"

## License

MIT