Create a new Location

​

Creates a new Location for Dynamic QR Code generation. The location starts with ACTIVE status and can be bound to a charge via the charge creation endpoints. Requires Idempotency-Key header.

Body·
required
application/json

Request to create a Bacen Pix location (payload-location URL).

  • tipoCob
    Type: string enum
    required

    Type of charge bound to the location (Bacen tipoCob)

    values
    • cob
    • cobv
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/loc
curl http://localhost:8080/api/loc \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "tipoCob": "cob"
}'

{
  "id": "string",
  "location": "string",
  "tipoCob": "cob",
  "status": "ACTIVE",
  "criacao": "2026-09-16T19:14:18.843Z"
}

Location created successfully