Skip to main content
POST
/
{alias}
/
pricing
/
wallet
/
transaction
Criar transação na carteira de cashback
curl --request POST \
  --url https://api.dooki.com.br/v2/{alias}/pricing/wallet/transaction \
  --header 'Content-Type: application/json' \
  --header 'User-Secret-Key: <api-key>' \
  --header 'User-Token: <api-key>' \
  --data '
{
  "customer_email": "cliente@example.com",
  "transaction_type": "credit",
  "amount": 15.5,
  "expires_at": "2026-12-31",
  "description": "Bonificação por indicação"
}
'
{
  "data": {
    "id": 10001,
    "transaction_type": "credit",
    "amount": 9.9,
    "used_amount": 0,
    "accumulated_amount": 9.9,
    "status": "approved",
    "cancelled_at": null,
    "description": null,
    "expires_at": "2026-01-31",
    "expired": 1,
    "customer": {
      "id": 200001,
      "name": "Cliente Exemplo",
      "email": "cliente@example.com",
      "phone": "5500000000000"
    },
    "order": {
      "id": 300001,
      "number": 123456789012
    },
    "created_at": {
      "date": "2000-08-17 10:24:24",
      "timezone_type": 3,
      "timezone": "America/Sao_Paulo"
    },
    "updated_at": {
      "date": "2000-08-17 10:24:24",
      "timezone_type": 3,
      "timezone": "America/Sao_Paulo"
    }
  }
}

Authorizations

​
User-Token
string
header
required
​
User-Secret-Key
string
header
required

Path Parameters

​
alias
string
required

Alias da loja

Body

application/json
​
customer_email
string<email>
required

E-mail do cliente. Deve pertencer a um cliente cadastrado na loja.

Example:

"cliente@example.com"

​
transaction_type
enum<string>
required

Tipo da transação: credit para adicionar saldo, debit para subtrair.

Available options:
credit,
debit
Example:

"credit"

​
amount
number<float>
required

Valor da transação.

Required range: x >= 0
Example:

15.5

​
expires_at
string<date>
required

Data de expiração do crédito no formato Y-m-d. Deve ser igual ou posterior a hoje.

Example:

"2026-12-31"

​
description
string
required

Descrição da transação (máximo 140 caracteres, pois o sufixo ' (via API)' é adicionado automaticamente).

Maximum string length: 150
Example:

"Bonificação por indicação"

Response

Transação criada com sucesso

​
data
object

Representa uma transacao de cashback na carteira do cliente.