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.

Headers
  • Idempotency-Key
    Type: string
    required

    Unique idempotency key to prevent duplicate location creation

Body·
required
application/json

Request to create a new Location for dynamic QR Code

  • type
    enum
    const:  
    DYNAMIC
    required

    Type of Location for QR Code generation

    values
    • DYNAMIC
Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/charges/locations
curl http://localhost:8080/api/v1/charges/locations \
  --request POST \
  --header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "type": "DYNAMIC"
}'

{
  "id": "string",
  "status": "ACTIVE",
  "createdAt": "2026-07-29T19:28:46.545Z"
}

Location created successfully