Endpoint: GET /sales/seller/{seller_id}/checkoutlink/{checkoutlink_pk}/payments/
Autenticação: Bearer JWT ou chave de API do vendedor (TokenAuth)
Retorna os pagamentos vinculados a um link de checkout, do mais recente para o mais antigo. Cada registro combina um comprador (cliente da transacao) com uma ou mais transacoes; o status do registro resume as transacoes associadas:
  • waiting — nenhuma transacao foi associada.
  • mixed — existem multiplos status distintos de transacao para este registro (raro).
  • caso contrario — o status unico compartilhado por todas as transacoes deste registro, ex.: succeeded, failed, pending, pre_authorized, reversed, refunded, partial_refunded, dispute, charged_back.
Paginado (tamanho padrao 10, maximo 100).

Pre-requisitos

  • O Link de checkout deve existir.
  • O chamador precisa de vinculo de acesso para seller_id.

Parametros de caminho

seller_id
string
required
UUID unificado da conta.
UUID do link de checkout ao qual estes pagamentos pertencem.

Parametros de consulta

page
integer
Numero da pagina (1-based).
page_size
integer
Tamanho da pagina, limitado a 100.

Resposta

Envelope padrao paginado.
count
integer
next
string | null
previous
string | null
results
array
Lista de resumos de pagamento.
Cada pagamento:
id
string
UUID do pagamento.
online_sell
object
Resumo do link de checkout pai: id, name, reference, amount, expiration_date.
customer
object
Dados do comprador: name, email, phone_number, country_code.
status
string
Status agregado (ver lista acima).
{
  "count": 4,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "11b3aa42-7e3e-4d56-a55a-2cbb33d3b1cc",
      "online_sell": {
        "id": "2c1f8a4e-3a3a-4f72-9d3c-1aa2f0c0aa11",
        "name": "Curso Online de Maio",
        "reference": "curso-maio-2026",
        "amount": "499.00",
        "expiration_date": "2026-06-30"
      },
      "customer": {
        "name": "Maria Souza",
        "email": "maria@example.com",
        "phone_number": "11999990000",
        "country_code": "+55"
      },
      "status": "succeeded"
    }
  ]
}

Acao adicional: exportar relatorio

Um endpoint GET /sales/seller/{seller_id}/checkoutlink/{checkoutlink_pk}/payments/report/ existe para baixar os mesmos dados em csv, xlsx ou txt. Selecione o formato via cabecalho Accept (text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, text/plain) ou via parametro de consulta format. A resposta e transmitida com Content-Disposition: attachment; filename="<sell-name>_<timestamp>.<format>".

Erros

StatusQuando
401Credenciais ausentes ou invalidas.
403Sem vinculo de acesso para seller_id.
404Link de checkout nao encontrado.

Exemplos

curl "https://api.dlpay.cloud/sales/seller/$SELLER_ID/checkoutlink/$CHECKOUT_ID/payments/" \
  -H "Authorization: Bearer $ACCESS_TOKEN"