Pular para o conteúdo principal
POST
/
api
/
v1
/
credits
/
purchase
curl -X POST "https://app.talkover.ai/api/v1/credits/purchase" \
  -H "Authorization: Bearer your_user_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "payment_method_id": "pm_uuid_1"
  }'

{
  "success": true,
  "data": {
    "amount_charged": 100.00,
    "currency": "USD",
    "new_balance": 250.00,
    "transaction_id": "txn_uuid_1"
  }
}

​
Comprar Créditos

Compra créditos para recarregar o saldo da sua conta. A transação é cobrada do método de pagamento salvo.
Este endpoint faz parte da API de Conta e é autenticado com um token de sessão de usuário.

​
Endpoint

POST /api/v1/credits/purchase

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token de sessão do usuário. Formato: Bearer <user_session_token>.
​
Content-Type
string
obrigatório
Deve ser definido como application/json

​
Corpo da requisição

​
amount
number
obrigatório
Valor de créditos a comprar, na moeda da conta. Deve ser maior que 0.
​
payment_method_id
string
ID do método de pagamento opcional. Se omitido, o método de pagamento padrão é cobrado.

​
Exemplos

curl -X POST "https://app.talkover.ai/api/v1/credits/purchase" \
  -H "Authorization: Bearer your_user_session_token" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00,
    "payment_method_id": "pm_uuid_1"
  }'

​
Resposta

{
  "success": true,
  "data": {
    "amount_charged": 100.00,
    "currency": "USD",
    "new_balance": 250.00,
    "transaction_id": "txn_uuid_1"
  }
}

​
Respostas de erro

​
402 — Pagamento Recusado

{
  "success": false,
  "message": "Payment method declined",
  "code": "PAYMENT_FAILED"
}

​
Observações