> ## 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 todos os links de pagamento que criou, veja o que foi pago e desative aqueles que já não quer ativos.

Veja todos os links que partilhou, o que receberam, e feche aqueles com que já acabou.

<Info>
  **Apenas na web.** Os links de pagamento são criados no Moove Widget e geridos em [moove.xyz/dashboard/payment-link](https://www.moove.xyz/dashboard/payment-link). A Moove App não tem ecrã de links de pagamento — o ecrã **Receber** partilha antes o seu identificador e o seu código QR.
</Info>

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

| Estado        | Significado                                            | Aceita pagamento |
| ------------- | ------------------------------------------------------ | ---------------- |
| **Ativo**     | Ativo e partilhado                                     | Sim              |
| **Concluído** | Pago na totalidade, ou atingiu o limite de utilizações | Não              |
| **Inativo**   | Desativou-o, ou expirou                                | Não              |

Filtre a lista por estado para ver o que ainda anda por aí.

## O que mostra cada link?

O painel lista os seus links numa só tabela. Estas são as colunas:

| Coluna                | O que mostra                                     |
| --------------------- | ------------------------------------------------ |
| **Criado**            | Quando o fez                                     |
| **Link**              | O URL que pode partilhar                         |
| **Valor**             | O que está a pedir, no seu token de liquidação   |
| **Status**            | Ativo, Concluído ou Inativo                      |
| **Data de expiração** | Quando deixa de aceitar pagamentos, ou **Nunca** |
| **Recebido**          | O que foi efetivamente pago contra ele           |
| **Descrição**         | O que quem paga vê                               |
| **Ação**              | **Ver**, **Compartilhar** e **Desativar**        |

## Como desativo um link?

<Steps>
  <Step title="Abra Gerir → Links de pagamento">
    No painel web.
  </Step>

  <Step title="Encontre o link">
    Filtre por **Ativo** se a lista for longa.
  </Step>

  <Step title="Desative-o">
    O estado passa a **inativo** e deixa de aceitar pagamentos de imediato.
  </Step>
</Steps>

<Warning>
  Desativar é um caminho só de ida. Um link inativo não pode ser reativado — crie antes um novo.

  Também não desfaz o envio do URL. Quem tiver o link continua a ter o URL; ele simplesmente deixa de funcionar. Se o link estiver numa página pública, retire-o também de lá.
</Warning>

## Deixar um link fechar-se sozinho

Um link criado no Moove Widget aceita **um único pagamento e nunca expira**. Fica concluído assim que é pago na totalidade, por isso um link de fatura arruma-se sozinho.

Os links criados através da [API](/api-reference/moove-receive/moove-payment-links) também podem definir dois limites:

* **`maxUsage`** — quantos pagamentos o link aceita antes de ficar concluído.
* **`expirationDate`** — quando deixa de aceitar pagamentos. Um link cuja validade passou fica **Inativo**.

<Tip>
  Para faturas, um link do Moove Widget já resolve: só pode ser pago uma vez. Se também precisar de um prazo, crie o link através da API com um `expirationDate`.
</Tip>

## Reconciliar com os Moove Transactions

Todos os pagamentos feitos através de um link estão associados ao id desse link. O id não aparece na tabela de Transações da web, por isso aí faça a correspondência pela descrição — ou pelo id do link através da API.

[Moove Transactions →](/pt-pt/manage/moove-transactions)

## Como faço isto em código?

A API lista os seus links com os mesmos estados e os mesmos campos, incluindo links criados a partir do painel ou por outra chave da sua conta — por isso é o endpoint com que deve reconciliar.

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

<Note>
  A API consegue criar e ler links. Desativar um link é uma ação do painel.
</Note>

[API dos Moove Payment Links →](/api-reference/moove-receive/moove-payment-links)

## O que ler a seguir

<CardGroup cols={3}>
  <Card title="Moove Receber" icon="hand-coins" href="/pt-pt/transact/moove-receive">
    Crie o próximo.
  </Card>

  <Card title="Moove API Keys" icon="key" href="/pt-pt/manage/moove-api-keys">
    Crie links em código.
  </Card>

  <Card title="Moove Transactions" icon="list" href="/pt-pt/manage/moove-transactions">
    Veja o que foi pago.
  </Card>
</CardGroup>

Todos os links contabilizados. O seu dinheiro. O seu movimento.