Conta

Transferência interna entre subcontas e a casa (sem PIX)

Move saldo DISPONÍVEL entre um cliente final (customer_ref) e a casa ("casa" = a própria chave), ou entre dois clientes, sem passar pelo PIX. Uso típico: cobrar a sua taxa do cliente (cliente → casa), bonificar ou devolver (casa → cliente). O congelado (retenção de 24h / MED) não se move. Subconta na carência do primeiro depósito não transfere (423 — só chaves com carência contratual). Idempotente por external_id. Dispara o evento saldo.transferido.

post/saldo/transferir

Request

  • Base URL: https://api.luniumpay.com
  • URL: https://api.luniumpay.com/saldo/transferir
  • Auth: API key in header X-API-Key

Request body

from_customer_refstring required

customer_ref de origem, ou "casa".

to_customer_refstring required

customer_ref de destino, ou "casa".

amount_centsinteger required
descricaostring

Aparece no extrato das duas pontas.

external_idstring

Identificador idempotente de até 64 caracteres. Mantenha o mesmo identificador e todos os parâmetros nos retries. A comparação de divergência varia por rota; não use o replay para alterar uma operação. 409 external_id_divergente sinaliza conflito detectado.

Response

Replay idempotente (idempotente: true).

Changes

No recorded changes to this operation across all 3 revisions of this API.