Gerar Código de Verificação

Realiza a emissão de códigos de verificação para autenticação de operações e/ou ativação de equipamentos vinculados ao lojista.

Endpoint

POST/v1/merchants/{merchantId}/verification-codes

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
merchantId	string	✓	Identificador único do lojista

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
numberOfCodes	integer	✓	Quantidade de códigos a serem gerados
expiresAt	string (ISO 8601)	—	Data e hora de expiração dos códigos (ex.: "2026-05-08T10:00:00Z")

Request

curl -X POST https://yby-dev.positivolabs.com.br/v1/merchants/{merchantId}/verification-codes \
  -H "Authorization: Bearer <accessToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "expiresAt": "2026-05-08T10:00:00Z",
    "numberOfCodes": 2
  }'

Resposta

{
  "data": [
    {
      "expiresAt": "2026-05-08T10:00:00Z",
      "code": "ABC123"
    },
    {
      "expiresAt": "2026-05-08T10:00:00Z",
      "code": "XYZ789"
    }
  ]
}

Campos da Resposta

Campo	Tipo	Descrição
data	array	Lista de códigos gerados
data[].code	string	Código de verificação
data[].expiresAt	string (ISO 8601)	Data e hora de expiração do código