Endpoint: POST /unified/accounts/sellers/{sellers_pk}/register-pos/
Autenticação: JWT obrigatório ou Chave de API aceita
Registra um terminal de Ponto de Venda (físico ou virtual) sob um seller. Internamente, a operação utiliza o token de sincronização impresso no aparelho para vincular o dispositivo à infraestrutura de processamento. Se o seller for uma sub-conta, o registro é efetuado contra a conta pai (sub-contas compartilham o registro de processamento do pai). Esta operação é exposta como uma ação dedicada, e não como um POST em /point-of-sale/. O recurso point-of-sale em si suporta apenas leitura (lista/detalhe) e atualização parcial (para reatribuir receiver_account). Após o registro bem-sucedido, o aparelho passa a enviar vendas e elas aparecem em transações unificadas; o registro de POS em si aparece em listar pontos de venda assim que o evento de notificação é recebido e a sincronização é executada.

Parâmetros de path

sellers_pk
string (uuid)
required
Identificador da conta unificada. Pode ser um SELLER_* ou SUB_SELLER_*.

Corpo

token
string
required
Token de sincronização exibido pelo terminal durante o fluxo de pareamento.

Resposta

200 OK.
message
string
String de confirmação. Atualmente "Point of Sale registered successfully.".
{
  "message": "Point of Sale registered successfully."
}

Erros

StatusQuando
400Token rejeitado pela infraestrutura de processamento. Corpo da resposta: {"message": "Sorry, but the provided token does not exist"}.
401Token ausente ou inválido.
403Solicitante não tem acesso ao seller.
404Seller não existe.

Exemplos

curl -X POST https://api.dlpay.cloud/unified/accounts/sellers/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/register-pos/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"token": "POS-SYNC-123456"}'