Skip to main content
POST
/
api
/
v1
/
public
/
points
/
credit
Creditar pontos
curl --request POST \
  --url https://api.indiqai.com/api/v1/public/points/credit \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "amount": 123,
  "client_id": "<string>",
  "reason": "Crédito via API Pública"
}
'
{
  "client_id": "550e8400-e29b-41d4-a716-446655440000",
  "balance": 1400,
  "empresa_id": "660f9500-f39c-52e5-b827-557766551111"
}

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.

​
Creditar Pontos

Adiciona pontos ao saldo de um cliente. Útil para integração com sistemas de vendas (ERP/PDV) que creditam pontos automaticamente após uma compra.

​
Comportamento atual

  • a rota aceita X-Idempotency-Key para retry seguro
  • o crédito é aplicado de forma atômica no saldo da carteira
  • a resposta retorna o saldo final, não o histórico completo da transação

​
Body Parameters

​
client_id
string
required
ID do cliente que receberá os pontos (UUID)
​
amount
integer
required
Quantidade de pontos a creditar. Deve ser maior que 0.
​
reason
string
Motivo do crédito (ex: “Compra #12345”, “Bonificação mensal”)

​
Request

curl -X POST "https://api.indiqai.com/api/v1/public/points/credit" \
  -H "X-API-Key: indiqai_sua_chave_aqui" \
  -H "X-Idempotency-Key: pontos-erp-2026-05-12-001" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "550e8400-e29b-41d4-a716-446655440000",
    "amount": 150,
    "reason": "Compra #12345 - R$ 150,00"
  }'

​
Response

{
  "client_id": "550e8400-e29b-41d4-a716-446655440000",
  "balance": 1400,
  "empresa_id": "660f9500-f39c-52e5-b827-557766551111"
}

​
Campos da Resposta

​
client_id
string
ID do cliente que recebeu os pontos
​
balance
integer
Novo saldo de pontos do cliente após o crédito
​
empresa_id
string
Empresa dona da carteira creditada

Headers

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

Chave de API

Body

application/json

Creditar pontos para cliente.

​
amount
integer
required

Quantidade de pontos a creditar

​
client_id
string
required

ID do cliente

​
reason
string | null
default:Crédito via API Pública
Maximum string length: 255

Response

Successful Response

Saldo de pontos de um cliente.

​
balance
integer
required
​
client_id
string
required
​
empresa_id
string
required