Payment Links

Um Payment Link é uma URL persistente de uma oferta. Cada visita abre uma sessão nova do checkout hospedado, com Pix simulado e cartões de teste, sem nenhum código do seu lado.

Operações

post /v1/payment-links — Criar Payment Link
get /v1/payment-links — Listar Payment Links
get /v1/payment-links/{id} — Consultar Payment Link
patch /v1/payment-links/{id}/status — Ativar ou desativar Payment Link
get /v1/public/payment-links/{id}/session — Abrir sessão de um Payment Link

Criar e compartilhar

Criar um link curl

curl -sS -X POST "$WOLF_API_URL/v1/payment-links" \
  -H "Authorization: Bearer $WOLF_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: link-oferta-curso-1" \
  -d '{ "offer_id": "off_..." }'

A oferta precisa estar active e ser do seu seller (senão 404/400). Ler exige offers:read; criar e mudar o status, offers:write.
A URL pública é https://checkout.v2.wolfpayteste.online/l/{id}. Também dá para criar e copiar links pelo painel, na oferta.
Desative com PATCH /v1/payment-links/{id}/status e {"status": "inactive"}; reative com active. O link continua o mesmo.
session_count e completed_session_count contam as sessões abertas e concluídas pelo link.

O que o comprador vê

Abrir o link mostra uma página intermediária; a sessão só é criada quando ela confirma (pré-visualizações de apps de mensagem e robôs não abrem sessões).
A sessão vale 60 minutos e mostra o nome público do seller, o produto, o valor e o banner permanente de simulação.
O comprador informa nome, e-mail e CPF opcional e escolhe Pix ou cartão de teste. O pagamento cria um pedido e um PaymentIntent; a confirmação mostra os ids.

Link inexistente, inativo, de oferta inativa ou de seller suspenso responde igual (404), sem revelar o motivo. Abrir links é limitado por IP (veja Rate limits).

O objeto PaymentLink

Objeto PaymentLink

Objeto PaymentLink
Campo	Tipo	Detalhes
`id` obrigatório	string	Padrão `^plk_[A-Za-z0-9]{1,64}$`
`offer_id` obrigatório	string	Começa com `off_`
`status` obrigatório	string	Valores: `active`, `inactive`
`session_count` obrigatório	integer	de 0 a 9007199254740991
`completed_session_count` obrigatório	integer	de 0 a 9007199254740991
`last_session_at` obrigatório	string \| null
`created_at` obrigatório	string
`updated_at` obrigatório	string

O link nunca expõe o id do seller. A sessão aberta pelo servidor do checkout (GET /v1/public/payment-links/{id}/session) é uma rota interna do checkout hospedado; integrações normalmente só compartilham a URL.