Skip to main content
POST
Request redemption
Draft: specification in progress. Endpoints and fields may change.

Authorizations

Authorization
string
header
required

The organization's API key (tesa_live_... in production, tesa_test_... in the sandbox).

Headers

Idempotency-Key
string<uuid>
required

Required for this operation. A network failure must not create two operations.

Body

application/json
valor
string
required

USDC amount, a decimal string with two decimal places.

Pattern: ^\d+\.\d{2}$
Example:

"842110.00"

carteira_destino_id
string
required

Linked wallet that receives the USDC. Redemptions only go to the company's own wallets.

referencia_interna
string

Free text for reconciliation, such as the payment batch in the ERP.

Response

Redemption created, pending approval.

id
string
Example:

"res_4t7x"

valor
string

USDC amount, a decimal string with two decimal places.

Pattern: ^\d+\.\d{2}$
Example:

"842110.00"

carteira_destino_id
string
referencia_interna
string | null
status
enum<string>
Available options:
pendente,
aprovado,
aguardando_assinatura,
concluido,
falhou
transacoes
object[]
criado_em
string<date-time>
concluido_em
string<date-time> | null