Links de pagamento

Links reutilizáveis de valor fixo, valor aberto ou de produto, para vender sem integrar o checkout.

O link de pagamento é uma página da Confido que vende várias vezes: você cria uma vez e divulga (site, rede social, WhatsApp). Cada compra vira uma venda, com os mesmos webhooks.

Cobrança	Link de pagamento
Para um cliente e um valor	Para qualquer pessoa, quantas vezes for
Tem vencimento e avisos	Fica no ar até você desativar ou atingir o limite de usos

Criar

curl -X POST https://api.confidoscm.com/api/v1/payment-links \
  -H "X-API-Key: $CONFIDO_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: link-camiseta" \
  -d '{
    "linkType": "fixed_amount",
    "name": "Camiseta Confido",
    "description": "Algodão, tamanhos P a GG",
    "amountCents": 7990,
    "allowQuantityChange": true,
    "maxQuantity": 5,
    "allowedPaymentMethods": "pix,credit_card,boleto"
  }'

`linkType`	Valor
`fixed_amount`	`amountCents` fixo
`open_amount`	O comprador digita, entre `minAmountCents` e `maxAmountCents` (opcionais)
`product`, `variation`, `plan`	O preço do produto, da variação ou do plano cadastrado no painel (`productId`, `variationId`, `planId`)

Outros campos úteis: imageUrls (até 5), allowCoupons, requiresShipping, maxUses e storeId. A lista completa está na Referência. A resposta traz o link com o endereço público para divulgar.

Gerenciar

Rota	O que faz
`GET /api/v1/payment-links`	Lista (filtros `search`, `status`, `linkType`, `methods`, `storeId`, `isActive`).
`GET /api/v1/payment-links/{id}`	Um link.
`POST /api/v1/payment-links/{id}/deactivate`	Para de aceitar vendas (a página avisa que está indisponível). As vendas feitas continuam.
`POST /api/v1/payment-links/{id}/activate`	Reativa.

Escopos: payment_links:read e payment_links:write. Para criar o link de uma subconta, use POST /api/v1/accounts/{id}/payment-links (veja Subcontas).