# mcp-izipay

Twenty tools for Izipay's acquirer API: authorize and capture charges, refunds, cuotas, card tokens, Yape and Plin. Built for Peruvian merchants under a direct contract.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/payments/izipay
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-izipay

## What it does

The server exposes charge authorization with a separate capture or void, refunds on captured payments, card tokenization for repeat billing, Peruvian installment plans, transaction listing and the daily settlement batch. Payment links, direct Yape and Plin payments, 3-D Secure completion and subscriptions round out the toolset.

Auth is JWT Bearer and handled for you. On the first call the server posts username, password and merchant code to `/auth/login`, keeps the returned token in memory and refreshes it 60 seconds before expiry. Credentials come from `IZIPAY_USERNAME`, `IZIPAY_PASSWORD`, `IZIPAY_MERCHANT_CODE`; `IZIPAY_ENV` picks `production` or `sandbox`, and `IZIPAY_BASE_URL` overrides the host.

Read the version before wiring it to real money: `0.1.0-alpha.1`. Izipay keeps its full REST reference behind a merchant contract, so the endpoint paths here were inferred from public SDK repositories and Niubiz conventions. The README asks you to check every one against your own integration kit first. Without that check the server is a draft, not a payment integration.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `IZIPAY_USERNAME`, `IZIPAY_PASSWORD`, `IZIPAY_MERCHANT_CODE`, `IZIPAY_ENV`, `IZIPAY_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env IZIPAY_USERNAME=<IZIPAY_USERNAME> --env IZIPAY_PASSWORD=<IZIPAY_PASSWORD> --env IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> --env IZIPAY_ENV=<IZIPAY_ENV> --env IZIPAY_BASE_URL=<IZIPAY_BASE_URL> --transport stdio izipay -- npx -y @codespar/mcp-izipay
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add izipay --env IZIPAY_USERNAME=<IZIPAY_USERNAME> --env IZIPAY_PASSWORD=<IZIPAY_PASSWORD> --env IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> --env IZIPAY_ENV=<IZIPAY_ENV> --env IZIPAY_BASE_URL=<IZIPAY_BASE_URL> -- npx -y @codespar/mcp-izipay
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "izipay": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-izipay"
            ],
            "env": {
                "IZIPAY_USERNAME": "<IZIPAY_USERNAME>",
                "IZIPAY_PASSWORD": "<IZIPAY_PASSWORD>",
                "IZIPAY_MERCHANT_CODE": "<IZIPAY_MERCHANT_CODE>",
                "IZIPAY_ENV": "<IZIPAY_ENV>",
                "IZIPAY_BASE_URL": "<IZIPAY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "izipay": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-izipay"
            ],
            "env": {
                "IZIPAY_USERNAME": "<IZIPAY_USERNAME>",
                "IZIPAY_PASSWORD": "<IZIPAY_PASSWORD>",
                "IZIPAY_MERCHANT_CODE": "<IZIPAY_MERCHANT_CODE>",
                "IZIPAY_ENV": "<IZIPAY_ENV>",
                "IZIPAY_BASE_URL": "<IZIPAY_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e IZIPAY_USERNAME=<IZIPAY_USERNAME> -e IZIPAY_PASSWORD=<IZIPAY_PASSWORD> -e IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> -e IZIPAY_ENV=<IZIPAY_ENV> -e IZIPAY_BASE_URL=<IZIPAY_BASE_URL> izipay npx -y @codespar/mcp-izipay
```
Replace <…> with your own values

## When to use it
- authorize a card payment and capture it as a second step
- set up a cuotas installment plan for a given card BIN and amount
- refund a charge that was already captured
- store a card token so repeat charges skip the PAN
- match transactions against a daily settlement batch

## Example prompts
- Create a 250 PEN charge without capturing it, I'll capture later
- List the cuota programs open to this card BIN on a 1200 PEN order
- Pull yesterday's settlement batch and reconcile it with my orders

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 40 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md