Registrar ponto de venda

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

string (uuid)

required

Identificador da conta unificada. Pode ser um SELLER_* ou SUB_SELLER_*.

Corpo

string

required

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

Resposta

200 OK.

string

String de confirmação. Atualmente "Point of Sale registered successfully.".

{
  "message": "Point of Sale registered successfully."
}

Erros

Status	Quando
`400`	Token rejeitado pela infraestrutura de processamento. Corpo da resposta: `{"message": "Sorry, but the provided token does not exist"}`.
`401`	Token ausente ou inválido.
`403`	Solicitante não tem acesso ao seller.
`404`	Seller 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"}'

import requests

response = requests.post(
    f"https://api.dlpay.cloud/unified/accounts/sellers/{seller_id}/register-pos/",
    headers={"Authorization": f"Bearer {access_token}"},
    json={"token": "POS-SYNC-123456"},
)
result = response.json()

const response = await fetch(
  `https://api.dlpay.cloud/unified/accounts/sellers/${sellerId}/register-pos/`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ token: "POS-SYNC-123456" }),
  },
);
const result = await response.json();

Início

Autenticação e usuários

Vendedores

Vendas

Planos

Contas unificadas

Eventos

Assinaturas

Contas virtuais

Integrações do vendedor

Registrar ponto de venda

Parâmetros de path

Corpo

Resposta

Erros

Exemplos

​Parâmetros de path

​Corpo

​Resposta

​Erros

​Exemplos

Parâmetros de path

Corpo

Resposta

Erros

Exemplos