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",
  "amount": 150,
  "new_balance": 1400,
  "reason": "Compra #12345 - R$ 150,00",
  "transaction_id": "txn_abc123",
  "created_at": "2026-03-20T14:00:00Z"
}

​
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.

​
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 "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",
  "amount": 150,
  "new_balance": 1400,
  "reason": "Compra #12345 - R$ 150,00",
  "transaction_id": "txn_abc123",
  "created_at": "2026-03-20T14:00:00Z"
}

​
Campos da Resposta

​
client_id
string
ID do cliente que recebeu os pontos
​
amount
integer
Quantidade de pontos creditados
​
new_balance
integer
Novo saldo de pontos do cliente após o crédito
​
reason
string
Motivo do crédito (pode ser null)
​
transaction_id
string
ID único da transação de pontos
​
created_at
string
Data da transação (ISO 8601)

Headers

​
X-API-Key
string
required

Chave de API da empresa

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