> ## Documentation Index
> Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clientes

> Crie e consulte registros de clientes na Pagou v2 quando seu produto usa perfis reutilizáveis.

Use customers quando o seu checkout reutiliza dados do comprador em vários pagamentos.

## Operações suportadas

* `POST /v2/customers`
* `GET /v2/customers`
* `GET /v2/customers/{id}`

## Quando usar este recurso

* Você quer um ID estável de cliente na Pagou.
* Seu produto armazena perfis reutilizáveis de pagador.
* Você quer criar o comprador uma vez e referenciá-lo depois.

## Exemplo de requisição

```bash theme={null}
curl --request POST \
  --url https://api.pagou.ai/v2/customers \
  --header "Authorization: Bearer SEU_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "document": {
      "type": "CPF",
      "number": "12345678901"
    },
    "externalRef": "customer_1001"
  }'
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "requestId": "0190a2b4-18a7-7de0-9a43-69b7cf261201",
  "data": {
    "id": "018f1f2e-7b46-7c9a-8d3e-1a2b3c4d5e73",
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "externalRef": "customer_1001"
  }
}
```

## Erro comum

Status `422`

```json theme={null}
{
  "type": "https://api.pagou.ai/problems/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "The request contains invalid data.",
  "errors": [
    {
      "field": "email",
      "message": "Invalid email format",
      "code": "invalid_string"
    }
  ]
}
```

Como corrigir: envie um email válido e mantenha o cliente ligado ao ID usado no seu sistema. Criar o cliente não substitui a idempotência das transações.

## Próximos passos

* [Status de transação](/pt/payments/transaction-statuses)
* [Receber pagamentos Pix](/pt/payments/pix/accept-payments)