---
title: "Atualiza a chave (nome, settlement, webhook, rotações)"
method: PATCH
path: "/keys/me"
---

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

`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`

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.

## Request body

- object
  - `name` string
  - `settlement_address` string, nullable: Endereço Polygon 0x…; null limpa.
  - `webhook_url` string, nullable: https pública; null limpa. Definir gera webhook_secret se a chave ainda não tem.
  - `rotate_webhook_secret` boolean: true gira o segredo do webhook — aparece UMA vez na resposta.
  - `rotate_monitor_token` boolean: 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_bps` integer: 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_bps` integer: 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_bps` integer: 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_bps` integer: 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 `200`

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

## Other responses

- `400`: Campos inválidos ou nada para atualizar.
- `401`: X-API-Key ausente, desconhecida ou incorreta.

## Changes

- **2026-10-19** `fc06c3b824b1`: 1 info
  - added the new optional request property `partner_deposito_fee_bps`

[Operation history](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/changes/keys/me/patch.md)

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)