Pular para o conteúdo principal
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

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

{
  "success": true,
  "requestId": "req_1101",
  "data": {
    "id": "cus_1001",
    "name": "Ada Lovelace",
    "email": "ada@example.com",
    "externalRef": "customer_1001"
  }
}

​
Erro comum

Status 422 
{
  "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 seu ID interno. Criar customer não substitui a idempotência de transactions.

​
Próximos passos