Link de pagamento

Cliente e itens

O pagador e os produtos vão no create. Não há cadastro prévio.

Não existe endpoint separado para cadastrar cliente ou produto. Os dois vão no POST /api/v2/checkout.

Cliente

Envie customer.name e customer.tax_id. E-mail, telefone e WhatsApp são opcionais.

O documento identifica o pagador na sua conta. Enviar o mesmo tax_id de novo atualiza o cadastro dessa conta. Outra conta, mesmo com o mesmo documento, não vê nem altera esse registro.

Com método BOLETO, customer.address é obrigatório. Sem endereço, o create responde 422.

Campo	Obrigatório	Formato
`postal_code`	Com boleto	Até 8 caracteres
`street`	Com boleto	Logradouro
`number`	Com boleto	Número
`complement`	Não	Complemento
`neighborhood`	Com boleto	Bairro
`city`	Com boleto	Cidade
`state`	Com boleto	UF com 2 letras

Itens

Omita items para cobrar só o amount (type UNIQUE).

Com items, cada linha precisa de code, name, quantity e unit_amount. O create devolve type SMART.

code é o SKU na sua conta. O mesmo código atualiza nome e preço. Não cria outro produto.
Outra conta pode usar o mesmo code sem interferir no seu.
Item sem code responde 422.
Se você enviar amount junto com itens, ele deve ser exatamente a soma quantity × unit_amount. Frete e desconto ficam de fora dessa conta.

Não há POST /customers nem POST /products nesta API.

Inativar link

POST /api/v2/checkout/{id}/inactivate no API Gateway cancela um link pendente ou vencido.

Retorno e notificação

Como o pagador volta para a loja e como a Nuvende avisa que o link foi pago.