Skip to main content
POST
/
api
/
v1
/
public
/
loyalty-cards
/
{card_id}
/
stamp
Carimbar cartão
curl --request POST \
  --url https://api.indiqai.com/api/v1/public/loyalty-cards/{card_id}/stamp \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "client_id": "<string>"
}
'
{
  "id": "progress_001",
  "client_id": "550e8400-e29b-41d4-a716-446655440000",
  "stamps": 8,
  "max_stamps": 10,
  "completed": false,
  "created_at": "2026-03-20T14:00:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.indiqai.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Carimbar Cartão

Adiciona um carimbo a um cartão fidelidade de um cliente. Se o cartão for completado, a recompensa é automaticamente disponibilizada.

​
Comportamento atual

  • a rota aceita X-Idempotency-Key para retry seguro
  • o card_id esperado aqui é o user_loyalty_progress.id retornado por GET /api/v1/public/loyalty-cards
  • a resposta atual retorna o shape de PublicLoyaltyCardResponse

​
Path Parameters

​
card_id
string
required
ID do progresso retornado por GET /api/v1/public/loyalty-cards

​
Body Parameters

​
client_id
string
required
ID do cliente dono do cartão (UUID)

​
Request

curl -X POST "https://api.indiqai.com/api/v1/public/loyalty-cards/progress_001/stamp" \
  -H "X-API-Key: indiqai_sua_chave_aqui" \
  -H "X-Idempotency-Key: loyalty-pdv-2026-05-12-001" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

​
Response

{
  "id": "progress_001",
  "client_id": "550e8400-e29b-41d4-a716-446655440000",
  "stamps": 8,
  "max_stamps": 10,
  "completed": false,
  "created_at": "2026-03-20T14:00:00Z"
}

​
Campos da Resposta

​
id
string
ID do progresso de fidelidade
​
client_id
string
ID do cliente dono do progresso
​
stamps
integer
Quantidade atual de carimbos após a operação
​
max_stamps
integer
Total de carimbos necessários
​
completed
boolean
Se o cartão foi completado com este carimbo
​
created_at
string
Data original de criação do progresso

Headers

​
X-Idempotency-Key
string | null
​
X-API-Key
string
required

Chave de API

Path Parameters

​
card_id
string
required

Body

application/json

Carimbar cartão de fidelidade.

​
client_id
string
required

ID do cliente

Response

Successful Response

Dados de um cartão de fidelidade.

​
id
string
required
​
client_id
string | null
​
completed
boolean
default:false
​
created_at
string<date-time> | null
​
max_stamps
integer
default:0
​
stamps
integer
default:0