> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moove.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Moove Payment Links

> Acompanhe cada link de pagamento que você criou, veja o que foi pago e desative os que você não quer mais ativos.

Veja todos os links que você compartilhou, quanto cada um recebeu, e encerre os que não precisa mais.

> [!NOTE]
>
> **Somente web.** Os links de pagamento são criados no Moove Widget e gerenciados em [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link). O Moove App não tem uma tela de links de pagamento: a tela **Receber** dele compartilha o seu handle e o seu QR code.

## Quais são os três status?

| Status | Significado | Aceita pagamento |
| - | - | - |
| **Ativo** | No ar e compartilhado | Sim |
| **Concluído** | Pago por completo ou chegou ao limite de usos | Não |
| **Inativo** | Você desativou ou ele expirou | Não |

Filtre a lista por status para ver o que ainda está em circulação.

## O que cada link mostra?

O painel lista os seus links em uma única tabela. Estas são as colunas:

| Coluna | O que mostra |
| - | - |
| **Criado** | Quando você o criou |
| **Link** | A URL para compartilhar |
| **Valor** | O que você está cobrando, no seu token de liquidação |
| **Status** | Ativo, Concluído ou Inativo |
| **Data de expiração** | Quando ele deixa de aceitar pagamentos, ou **Nunca** |
| **Recebido** | O que de fato foi pago por ele |
| **Descrição** | O que quem paga vê |
| **Ação** | **Ver**, **Compartilhar** e **Desativar** |

## Como desativo um link?

**1. Abra Gerenciar → Links de pagamento**

No painel da web.

**2. Encontre o link**

Filtre por **Ativo** se a lista for longa.

**3. Desative-o**

O status dele passa a **inativo** e ele deixa de aceitar pagamentos na hora.

> [!WARNING]
>
> Desativar não tem volta. Um link inativo não pode ser reativado: crie um novo.
>
> Isso também não desfaz o envio da URL. Quem tem o link continua com a URL; ela só deixa de funcionar. Se o link estiver em uma página pública, tire-o de lá também.

## Deixando um link se encerrar sozinho

Um link criado no Moove Widget aceita **um pagamento e nunca expira**. Ele é concluído assim que é pago por completo, então um link de fatura se encerra sozinho.

Links criados pela [API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md) também podem definir dois limites:

* **`maxUsage`**: quantos pagamentos o link aceita antes de ser concluído.
* **`expirationDate`**: quando ele deixa de aceitar pagamentos. Um link depois da expiração passa a **Inativo**.

> [!TIP]
>
> Para faturas, um link do Moove Widget já resolve: ele só pode ser pago uma vez. Se você também precisa de um prazo, crie o link pela API com um `expirationDate`.

## Conciliando com o Moove Transactions

Todo pagamento feito por um link fica vinculado ao id desse link. O id não aparece na tabela de Transações da web, então faça a correspondência pela descrição, ou pelo id do link na API.

[Moove Transactions →](https://docs.moove.xyz/pt-br/manage/moove-transactions.md)

## Como faço isso no código?

A API lista os seus links com os mesmos status e os mesmos campos, inclusive links criados pelo painel ou por outra chave da sua conta, então é o endpoint certo para conciliar.

```bash theme={null}
curl -sS "https://api.moove.xyz/v1/payment-link?status=active" \
  -H "X-API-Key: $MOOVE_API_KEY"
```

> [!NOTE]
>
> A API pode criar e ler links. Desativar um link é uma ação do painel.

[Moove Payment Links API →](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)

## O que ler em seguida

> [card] [Moove Receive](https://docs.moove.xyz/pt-br/transact/moove-receive.md)
>
> Crie o próximo.

> [card] [Moove API Keys](https://docs.moove.xyz/pt-br/manage/moove-api-keys.md)
>
> Crie links no código.

> [card] [Moove Transactions](https://docs.moove.xyz/pt-br/manage/moove-transactions.md)
>
> Veja o que foi pago.

Todos os links sob controle. Seu dinheiro. Sua jogada.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.