Link de Pagamento
Visão Geral
Geração e gerenciamento de links de pagamento
Links de pagamento permitem cobrar um pagador por uma URL, aceitando um ou mais métodos de pagamento (cartão e/ou PIX).
Endpoints
| Operação | Método e rota |
|---|---|
| Criar link | POST /api/v1/link-payment |
| Listar links | GET /api/v1/link-payment |
| Consultar link | GET /api/v1/link-payment/{linkPaymentUuid} |
| Verificar link | GET /api/v1/link-payment/check/{linkPaymentUuid}/{verificationCode} |
| Confirmar pagamento | PUT /api/v1/link-payment/confirm-payment/{linkPaymentUuid} |
| Cancelar link | PUT /api/v1/link-payment/{linkPaymentUuid}/cancel |
Fluxo do link
O lojista cria o link e o envia ao pagador. O pagador valida a cobrança com o código de verificação e confirma o pagamento. Enquanto não confirmado, o link pode ser cancelado.
Status do link
| Status | Código | Significado |
|---|---|---|
CREATED | 1 | Link gerado, aguardando pagamento |
EXPIRED | 2 | Prazo de expiração atingido sem pagamento |
PAID | 3 | Pagamento confirmado |
CANCELED | 4 | Link cancelado via PUT /{linkPaymentUuid}/cancel |