Este guia assume que você já possui um usuário na DLPay. Caso ainda não tenha, entre em contato com o time da DLPay ou utilize o endpoint de registro de conta.

1. Obtenha um token de acesso

A DLPay autentica usuários com tokens JWT no padrão Bearer. Troque seu e-mail e senha por um token access e um token refresh.
curl -X POST https://api.dlpay.cloud/user/login/ \
  -H "Content-Type: application/json" \
  -d '{
    "email": "voce@exemplo.com",
    "password": "sua-senha"
  }'
A resposta traz:
{
  "refresh": "eyJhbGciOiJIUzI1NiIs...",
  "access": "eyJhbGciOiJIUzI1NiIs...",
  "access_token_renew_interval": "86400",
  "user": { "id": 12, "email": "voce@exemplo.com", "...": "..." }
}
Envie o token access no cabeçalho Authorization nas chamadas seguintes:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
Quando o token de acesso expirar, troque o token refresh por um novo par em Renovar sessão.

2. Liste as contas de vendedor que você pode gerenciar

Todo usuário autenticado está associado a um ou mais vendedores por meio da tabela de acessos. Liste as contas unificadas que você pode operar:
curl https://api.dlpay.cloud/unified/accounts/sellers/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Anote o id de uma das contas retornadas. Esse é o seu seller_id, usado em todos os caminhos aninhados.

3. Faça uma chamada no escopo de um vendedor

Por exemplo, listar as transações mais recentes desse vendedor:
curl "https://api.dlpay.cloud/unified/accounts/sellers/$SELLER_ID/transactions/" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Próximos passos

Autenticação em detalhe

Tempo de vida dos tokens, estratégia de refresh, chaves de API e recuperação de senha.

Convenções

Estrutura de URLs, paginação, filtros e formato de erros.

Fluxo de transação

Percorra a criação, liquidação e split de uma transação.

Fluxo de assinatura

Configure cobrança recorrente para seus clientes.