Endpoint: PUT/PATCH /sales/seller/{seller_id}/checkoutlink/{id}/
Autenticação: Bearer JWT ou chave de API do vendedor (TokenAuth)
Atualiza um registro de venda online. PUT exige o conjunto completo de campos editaveis; PATCH aceita corpo parcial. Pagamentos existentes sob este link mantem seus dados — apenas a configuracao do proprio link e alterada. A atualizacao de amount afeta somente futuros clientes que pagarem o link, ja que pagamentos anteriores geraram transacoes proprias com o valor capturado.

Pre-requisitos

  • O link de checkout deve existir — veja Criar link de checkout.
  • O chamador precisa de vinculo de acesso para seller_id.

Parametros de caminho

seller_id
string
required
UUID unificado da conta.
id
string
required
UUID do link de checkout.

Corpo da requisicao

Todos os campos sao editaveis. Para PUT, todos os campos obrigatorios devem estar presentes; para PATCH, envie somente o que quiser mudar.
payment_plan
string
UUID de outro Plano de pagamento do mesmo vendedor.
name
string
Nome exibido. Maximo 255 caracteres.
reference
string
Referencia externa. Maximo 100 caracteres.
description
string
Descricao longa.
amount
string
Valor decimal em reais.
expiration_date
string
Data ISO-8601 (YYYY-MM-DD).

Resposta

Retorna o link atualizado, com a mesma estrutura de Buscar link de checkout.
{
  "id": "2c1f8a4e-3a3a-4f72-9d3c-1aa2f0c0aa11",
  "payment_plan": "f2c0c1a4-9c98-4e6e-bd14-7c5a3a6b1bcd",
  "name": "Curso Online de Maio (atualizado)",
  "reference": "curso-maio-2026",
  "description": "Acesso vitalicio ao curso online.",
  "amount": "549.00",
  "expiration_date": "2026-07-31",
  "link": "https://painel.dlpay.cloud/pagar/2c1f8a4e-3a3a-4f72-9d3c-1aa2f0c0aa11",
  "payment_count": 4
}

Erros

StatusQuando
400Validacao de campo falhou (por exemplo payment_plan desconhecido).
401Credenciais ausentes ou invalidas.
403Sem vinculo de acesso para seller_id.
404Link de checkout nao encontrado.

Exemplos

curl -X PATCH "https://api.dlpay.cloud/sales/seller/$SELLER_ID/checkoutlink/$CHECKOUT_ID/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"amount": "549.00", "expiration_date": "2026-07-31"}'