Izipay

v0.2.0-alpha.1API Keyalpha

Peru enterprise acquirer (Niubiz-backed — Visa + local banks). Complements Culqi (Peru SMB) for serious-volume Peruvian merchants. Alpha on npm — all endpoint paths best-guess since developers.izipay.pe is contract-gated.

20 tools5 env vars🇵🇪 Perualpha — pending validation

Install

terminal

$ npm install @codespar/mcp-izipay@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "izipay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-izipay@alpha"
      ],
      "env": {
        "IZIPAY_USERNAME": "<your_izipay_username>",
        "IZIPAY_PASSWORD": "<your_izipay_password>",
        "IZIPAY_MERCHANT_CODE": "<your_izipay_merchant_code>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try create_charge first.

Environment variables · 5

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

IZIPAY_USERNAME

required

Izipay merchant username issued with your acquirer contract

IZIPAY_PASSWORD

requiredsecret

Izipay merchant password used to obtain JWT

IZIPAY_MERCHANT_CODE

required

Izipay merchant code (codigoComercio)

IZIPAY_ENV

optional

Environment: sandbox or production. Defaults to production.

IZIPAY_BASE_URL

optional

Izipay API base URL. Defaults per IZIPAY_ENV. Override if your contract issues a custom host.

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_charge

Authorize a card payment. Supports 3-D Secure (3DS) challenge flow when required by issuer/brand. Set capture=true for authorize+capture atomically; capture=false to authorize only and capture later via capture_charge.

WRITEcapture_charge

Capture a previously authorized charge (when capture=false was used in create_charge).

DELETEcancel_charge

Void an authorized-but-uncaptured charge. Does not work on captured charges — use refund_charge for those.

DELETErefund_charge

Refund a captured charge. Pass amount for a partial refund; omit for a full refund.

WRITEget_charge

Retrieve a charge by Izipay charge id.

WRITEtokenize_card

Tokenize a card for PCI-safe reuse. Returns a token_id to pass into create_charge.card.token_id.

DELETEdelete_token

Delete a stored card token.

WRITEcreate_installment_plan

Create a Peruvian cuotas (installment) plan on a charge. Enables splitting a card payment into N monthly installments, with or without interest, per the issuer's cuota program.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.