# Getnet — how to use (mcp.ai)

Getnet acquirer (Santander) via the Plataforma Digital API, read-only: consult a transaction by payment_id (credit, debit, PIX, boleto), the tokenized card vault and customers. Does not create or change charges. Note, sales statement and receivables are not part of this API (they live in Extrato Eletrônico and Conciliador, separate Getnet products). Auth via the Plataforma Digital keys (client_id, client_secret and seller_id) generated in the Getnet panel.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_getnet?ms=1781857500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `getnet_get_card`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/getnet`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/getnet/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/getnet/get/card` — Consulta um cartão tokenizado do cofre (vault) por card_id (não retorna o PAN).
  - body: { card_id: string, account?: string, card_ids?: string[] }
- `POST https://api.mcp.ai/api/getnet/get/payment` — Consulta o status de uma transação por payment_id. `tipo` seleciona o meio (credit, debit, pix, boleto). Somente leitura, não cria nem altera cobrança.
  - body: { tipo: string, payment_id: string, account?: string, payment_ids?: string[] }
- `POST https://api.mcp.ai/api/getnet/list/accounts` — Lista os lojistas (seller_id) Getnet conectados a este install — id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/getnet/list/customer/cards` — Lista os cartões tokenizados de um cliente no cofre (vault).
  - body: { customer_id: string, account?: string, customer_ids?: string[] }
- `POST https://api.mcp.ai/api/getnet/list/customers` — Lista clientes cadastrados. Paginado por `page`/`limit`.
  - body: { page?: integer, limit?: integer, account?: string }

## Example prompts
- "Check the status of credit transaction <payment_id>"
- "List the tokenized cards of customer <customer_id>"
- "List the registered customers"

## More
- Page: https://mcp.ai/getnet
- Agent spec (llms.txt): https://mcp.ai/getnet/llms.txt
- Postman collection: https://mcp.ai/getnet/postman.json