Atualiza a chave (nome, settlement, webhook, rotações)

Changed on

Quatro subfees independentes: compra (partner_fee_bps), depósito Pix em saldo BRL (partner_deposito_fee_bps), venda (partner_cashout_fee_bps) e saída da custódia (partner_saque_fee_bps). Configure via PATCH /keys/me. Depósito credita comissão somente após Pix liberado e saldo creditado (paid/sent), uma vez por cobrança, com a taxa congelada na criação. Venda exige PIX pago; saída exige saque concluído. Não há cobrança retroativa. Limite e política de saque em politica.saque e min_saque_cents.

patch/keys/me

Request

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

Request body

namestring
settlement_addressstring nullable

Endereço Polygon 0x…; null limpa.

webhook_urlstring nullable

https pública; null limpa. Definir gera webhook_secret se a chave ainda não tem.

rotate_webhook_secretboolean

true gira o segredo do webhook — aparece UMA vez na resposta.

rotate_monitor_tokenboolean

true gira o token do monitor: a URL antiga deixa de mostrar dados a partir desta chamada; a nova vem em monitor_url.

partner_fee_bpsinteger

Sub fee do parceiro em bps, somada à taxa da Lunium e paga pelo usuário final (100 = 1%; máximo 1000 = 10%). Vale para cobrança NOVA: cobrança aberta mantém a taxa congelada. 0 desliga.

partner_cashout_fee_bpsinteger

Sub fee do parceiro na VENDA (cripto -> PIX), em basis points, POR CIMA da taxa da Lunium. Congelada em cada ordem no momento da criacao; vale para ordem nova. Nao se aplica a venda por QR copia e cola. 0 desliga.

partner_saque_fee_bpsinteger

Sub fee do parceiro na SAIDA DA CUSTODIA (saque por PIX em POST /payouts e saque em cripto em POST /saldo/sacar-cripto), em basis points, debitada do saldo POR CIMA da taxa da Lunium. Credita quando o saque conclui. 0 desliga.

partner_deposito_fee_bpsinteger

Subfee exclusiva do depósito Pix em saldo BRL, em basis points (100 = 1%). Padrão 0, máximo 1000. Aplicada ao valor recebido após a taxa fixa Lunium, descontada antes do crédito no saldo. Independente de compra, venda e saque. Congelada na criação; comissão creditada somente após liberação e crédito concluído (paid/sent).

Response

Chave atualizada. Pode trazer webhook_secret (uma única vez) e monitor_url novo.

Changes