---
title: "/api_validar_pin"
method: POST
path: "/api_validar_pin"
---

# /api_validar_pin

`POST /api_validar_pin`

Este endpoint é responsável por confirmar que o número de celular informado pelo cliente no Inicio é de fato dele.

## Headers

- `Authorization` string, required
- `CodEmpresa` string, required
- `Celular` integer, required
- `Content-Type` string, required
- `System-Name` string, required
- `User-Agent` string, required

## Request body

- object
  - `pin` string, required — Código de quatro dígitos enviado para o cliente.
  - `loja_id` integer, required — ID da loja na CRM&Bônus.
  - `customer_id` integer, required — ID do cliente na CRM&Bônus.

## Response `200`

200

- object
  - `status` true | false — Se houve sucesso/falha em sua solicitação
  - `message` string — Mensagem de sucesso/falha da sua solicitação. [Confira as mensagens de erro](https://crmbonus-api.readme.io/reference/erros-pdv-v1#post-api_validar_pin) desta rota.
  - `data` object — Conteúdo do retorno
    - `loja_id` integer — ID correspondente à esta loja
    - `customer_id` integer — ID do consumidor
    - `valid_pin` true | false — - `true` → PIN válido - `false` → PIN inválido
    - `pin_master` true | false — Se o PIN validado é um PIN Master
    - `can_used_pin_master` true | false — Se é possível usar o PIN Master

---

[API](https://skmtc.net/crmbonus/apis/bi-crmb-nus.md) · [All operations](https://skmtc.net/crmbonus/apis/bi-crmb-nus/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crmbonus/bi-crmb-nus/versions/7f3ebb042f1a/schema)