Skip to main content
Use customers when you want a durable buyer record outside the transaction payload itself.

​
Supported operations

  • POST /v2/customers
  • GET /v2/customers
  • GET /v2/customers/{id}

​
When to use this resource

  • Your checkout reuses a known buyer profile.
  • Your operations team needs a stable Pagou customer ID.
  • You want to decouple customer creation from transaction creation.

​
Create a customer

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

​
Response expectations

Store the Pagou customer id in your system and treat it as an external platform identifier, not your primary key.

​
Production notes

  • Keep your own internal customer ID and Pagou customer ID linked.
  • Validate customer ownership and tenant mapping on your side before reuse.
  • Do not treat customer creation as a substitute for transaction idempotency.