> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mingopay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Primeira integração

> Crie e confirme sua primeira cobrança Pix no sandbox.

## Antes de começar

Para integrar com JavaScript ou TypeScript, use o [SDK oficial para Node.js](https://docs.mingopay.com.br/documentation/sdk.md). Os exemplos HTTP abaixo continuam disponíveis para outras linguagens.

Você precisa de uma chave `mp_test_` com os escopos `payment_intents:write` e `payment_intents:read`. Gere a chave no dashboard e armazene-a em um gerenciador de segredos.

```bash theme={"system"}
export MINGOPAY_API_KEY="mp_test_substitua_pela_sua_chave"
```

## 1. Criar a cobrança

```bash theme={"system"}
curl -X POST "https://api.mingopay.com.br/v1/payment-intents" \
  -H "Authorization: Bearer $MINGOPAY_API_KEY" \
  -H "Idempotency-Key: pedido-1024-cobranca-001" \
  -H "Content-Type: application/json" \
  -d '{
    "externalReference": "pedido_1024",
    "amountCents": 14990,
    "method": "pix",
    "description": "Pedido 1024",
    "payer": {
      "name": "Cliente Exemplo",
      "taxId": "52998224725",
      "email": "cliente@example.com"
    }
  }'
```

A resposta `201` inclui `pix.copyPasteCode`, `pix.expiresAt` e a cobrança com estado `pending`.

## 2. Confirmar no sandbox

```bash theme={"system"}
curl -X POST \
  "https://api.mingopay.com.br/v1/sandbox/payment-intents/$PAYMENT_ID/confirm" \
  -H "Authorization: Bearer $MINGOPAY_API_KEY"
```

## 3. Consultar o estado

```bash theme={"system"}
curl "https://api.mingopay.com.br/v1/payment-intents/$PAYMENT_ID" \
  -H "Authorization: Bearer $MINGOPAY_API_KEY"
```

Quando o estado for `paid`, o pagamento foi confirmado. Em produção, use o webhook assinado como fluxo principal e a consulta para reconciliação.

> [!NOTE]
>
> O sandbox exercita a API e o ledger interno, mas não prova credenciais, liquidação ou disponibilidade do provedor de produção.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.