---
title: "Criar transação na carteira de cashback"
method: POST
path: "/{alias}/pricing/wallet/transaction"
tags: ["Promoções - Carteira"]
---

# Criar transação na carteira de cashback

`POST /{alias}/pricing/wallet/transaction`

Cria uma transação de crédito ou débito na carteira de cashback do cliente. O sufixo ' (via API)' é adicionado automaticamente à descrição. Rate limit: 5 requisições por minuto.

## Path parameters

- `alias` string, required

## Request body

- object
  - `customer_email` string, email, required — E-mail do cliente. Deve pertencer a um cliente cadastrado na loja.
  - `transaction_type` 'credit' | 'debit', required — Tipo da transação: credit para adicionar saldo, debit para subtrair.
  - `amount` number, float, required — Valor da transação.
  - `expires_at` string, date, required — Data de expiração do crédito no formato Y-m-d. Deve ser igual ou posterior a hoje.
  - `description` string, required — Descrição da transação (máximo 140 caracteres, pois o sufixo ' (via API)' é adicionado automaticamente).

## Response `200`

Transação criada com sucesso

- object
  - `data` WalletTransaction — Representa uma transacao de cashback na carteira do cliente.
    - `id` integer
    - `transaction_type` 'credit' | 'debit' — Tipo da movimentacao da carteira.
    - `amount` number, float
    - `used_amount` number, float
    - `accumulated_amount` number, float
    - `status` string — Status da transacao.
    - `cancelled_at` string, date-time, nullable
    - `description` string, nullable
    - `expires_at` string, date, nullable
    - `expired` integer — 1 quando expirado, 0 quando disponivel.
    - `customer` object
      - `id` integer, required
      - `name` string, required
      - `email` string, email, required
      - `phone` string, required
    - `order` object
      - `id` integer, required
      - `number` integer, required
    - `created_at` BaseTimestamp
      - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer — Número de representação do timezone.
      - `timezone` string — Fuso horário associado.
    - `updated_at` BaseTimestamp
      - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer — Número de representação do timezone.
      - `timezone` string — Fuso horário associado.

## Other responses

- `422` — Erro de validação
- `429` — Rate limit excedido

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)