Skip to main content
PI

PicPay

v0.2.0-alpha.2API Keyalpha

Billetera digital brasileña con más de 60M de usuarios. API de checkout para merchants para pagos, planes de recurrencia y suscripciones. Release alpha en npm — pagos core verificados, formatos del payload de recurrencia pendientes de validación en sandbox.

20 herramientas3 env vars🇧🇷 Brasilalpha — validación pendiente

Qué puede hacer tu agente

PicPay le da a tu agente 20 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_paymentCreate a PicPay checkout payment. Returns paymentUrl (redirect the buyer to the PicPay app / web) and qrcode (content + base64 image). The buyer pays inside PicPay; your callbackUrl receives the status update. value is in BRL as a decimal number (e.g. 20.50).
  • get_payment_statusGet the status of a payment by referenceId. Typical statuses: created, expired, analysis, paid, completed, refunded, chargeback.
  • cancel_paymentCancel a PicPay order. If the order is unpaid, it is voided. If already paid, this triggers a refund (requires merchant account balance to cover).
Ejemplo de llamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-picpay@alpha

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "picpay": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-picpay@alpha"
      ],
      "env": {
        "PICPAY_TOKEN": "<your_picpay_token>",
        "PICPAY_SELLER_TOKEN": "<your_picpay_seller_token>"
      }
    }
  }
}

Después de reiniciar, tu agente puede llamar cualquiera de las 20 herramientas de abajo — probá create_payment primero.

Variables de entorno · 3

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

PICPAY_TOKEN
obligatoriosecret

PicPay merchant integration token (sent as x-picpay-token header)

PICPAY_SELLER_TOKEN
obligatoriosecret

PicPay seller token used to validate webhook callbacks (x-seller-token header)

PICPAY_BASE_URL
opcional

PicPay ecommerce API base URL. Defaults to https://appws.picpay.com/ecommerce/public.

Herramientas disponibles · 20

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

WRITEcreate_payment
Create a PicPay checkout payment. Returns paymentUrl (redirect the buyer to the PicPay app / web) and qrcode (content + base64 image). The buyer pays inside PicPay; your callbackUrl receives the status update. value is in BRL as a decimal number (e.g. 20.50).
WRITEget_payment_status
Get the status of a payment by referenceId. Typical statuses: created, expired, analysis, paid, completed, refunded, chargeback.
DELETEcancel_payment
Cancel a PicPay order. If the order is unpaid, it is voided. If already paid, this triggers a refund (requires merchant account balance to cover).
WRITEcreate_plan
Create a subscription plan (Recurrency API). Plans define the recurring amount, frequency, and trial.
READlist_plans
List all subscription plans registered for this merchant.
WRITEupdate_plan
Update an existing subscription plan.
DELETEdelete_plan
Delete a subscription plan. Fails if the plan has active subscriptions.
WRITEcreate_subscription
Enroll a buyer in a subscription plan. Returns the subscription record and the buyer-facing authorization URL.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-picpay` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
PicPay — MCP server · 20 tools | CodeSpar