MCP server for ePayco — Colombian payment gateway (Davivienda-owned): card tokenization and charges, PSE bank debit, and cash networks (Efecty, Gana, Red Servi, Punto Red, Su Red).

The tool set mirrors the official ePayco SDKs (epayco-node): the card/token API on api.secure.payco.co and the restpagos API on secure.payco.co for PSE and cash. Test mode is a payload flag (EPAYCO_TEST), not a separate host.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "epayco": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-epayco"],
      "env": {
        "EPAYCO_PUBLIC_KEY": "your-public-key",
        "EPAYCO_PRIVATE_KEY": "your-private-key",
        "EPAYCO_TEST": "true"
      }
    }
  }
}

Claude Code

claude mcp add epayco --env EPAYCO_PUBLIC_KEY=pk --env EPAYCO_PRIVATE_KEY=sk -- npx -y @codespar/mcp-epayco

Tools (8)

Tool	Description
`tokenize_card`	Create a card token (`POST /v1/tokens`)
`create_customer`	Create a customer bound to a card token
`charge_card`	Charge a tokenized card (`POST /payment/v1/charge/create`)
`get_transaction`	Transaction detail by referencePayco
`create_pse_payment`	PSE bank debit — returns the bank redirect URL
`get_pse_transaction`	PSE transaction status by transaction id
`list_pse_banks`	PSE bank list
`create_cash_payment`	Cash voucher on efecty / gana / redservi / puntored / sured

Environment

Variable	Required	Description
`EPAYCO_PUBLIC_KEY`	yes	Public key
`EPAYCO_PRIVATE_KEY`	yes	Private key
`EPAYCO_TEST`	no	`"true"` (default) flags payloads as test mode

Docs

Provider docs: https://docs.epayco.com
Managed tier (one interface across every LATAM provider, governance + audit): https://codespar.dev/agents

Enterprise

Need governance, budget limits, and audit trails for agent-driven payments on ePayco? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.