Unbind Location (Bacen DELETE /loc/{id}/txid)

​

Unbinds the current charge from a Location, making it available for reuse. Sets the currentTxId to null and changes the status back to ACTIVE. Requires Idempotency-Key header. Bacen API Pix v2.9.0: DELETE /loc/{id}/txid

Path Parameters
  • id
    Type: string Format: uuid
    required

    Unique identifier of the location to unbind

Headers
  • x-branch
    Type: string
    required

    Branch of the location owner account

  • x-account-number
    Type: string
    required

    Number of the location owner account

  • Idempotency-Key
    Type: string
    required

    Unique idempotency key

Responses
  • application/json
  • application/json
  • application/json
Request Example for delete/loc/{id}/txid
curl http://localhost/loc/2a8cbd7d-0c7b-4a69-a1e1-4a19e8b7a2aa/txid \
  --request DELETE \
  --header 'x-branch: ' \
  --header 'x-account-number: ' \
  --header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "id": "string",
  "location": "string",
  "tipoCob": "cob",
  "status": "ACTIVE",
  "txid": "string",
  "criacao": "2026-07-31T12:59:10.307Z"
}

Location unbound successfully