Gateway mexicano do BBVA — a alternativa MX à Conekta. Cartões, OXXO, SPEI, assinaturas (nativas), payouts de marketplace. Fecha a história das trilhas BBVA pro México.
O Openpay dá ao seu agente 23 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.
create_charge — Create a charge. Pass customer_id to charge at a customer scope (POST /customers/{customer_id}/charges); omit to charge at merchant scope (POST /charges). Methods: 'card' (requires source_id token), 'bank_account' (SPEI — returns CLABE reference), 'store' (OXXO — returns barcode/reference). Amounts are in major units (e.g. 100 = 100 MXN).get_charge — Retrieve a charge. Pass customer_id to fetch at customer scope (GET /customers/{customer_id}/charges/{id}); omit for merchant scope (GET /charges/{id}).capture_charge — Capture a previously authorized charge (when the original charge used capture=false). Pass amount to capture less than the authorized total; omit to capture the full authorized amount.// 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_charge", { /* ... */ });$ npm install @codespar/mcp-openpayAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"mcpServers": {
"openpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-openpay"
],
"env": {
"OPENPAY_MERCHANT_ID": "<your_openpay_merchant_id>",
"OPENPAY_PRIVATE_KEY": "<your_openpay_private_key>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 23 ferramentas abaixo — teste create_charge primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
OPENPAY_MERCHANT_IDOpenpay merchant id (forms part of the API URL path)
OPENPAY_PRIVATE_KEYOpenpay private API key (used as HTTP Basic auth username with empty password)
OPENPAY_ENVEnvironment: 'sandbox' (default) or 'production'. Selects between https://sandbox-api.openpay.mx and https://api.openpay.mx.
Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.
create_chargeget_chargecapture_chargerefund_chargecreate_customerget_customerlist_customerscreate_cardMCP é um protocolo — qualquer framework que o fale pode montar este server.