---
title: "/pin/send"
method: POST
path: "/pin/send"
---

# /pin/send

`POST /pin/send`

Inicialização do fluxo e envio do PIN de 4 dígitos para o celular do cliente

## Headers

- `Content-Type` string, required
- `System-Name` string, required
- `User-Agent` string, required
- `Request-Hash` string, required

## Request body

- object
  - `gross_value` integer — Valor bruto da compra
  - `customer` object, required — Dados do cliente
    - `country_code` integer, required — DDI do celular do consumidor
    - `phone` integer, required — DDD + Número de celular do consumidor
    - `name` string — Nome do consumidor
    - `email` string — E-mail do consumidor
    - `birth` string — Data de nascimento — Formato `AAAA/MM/DD`
    - `gender` 'M' | 'F' | 'O' — Gênero do consumidor <br>M — Male <br> F — Female <br> O — Others
    - `document_type` 'CPF' | 'RG' | 'CNH' | 'CNPJ' | 'PASSPORT' — Tipo do documento do consumidor
    - `document_number` string — Número do documento
    - `category_custom` string
    - `custom_data` object — Dados customizáveis
      - `key` string — Seu dado customizável
  - `items` object[], required — Itens que compõem a venda
    - `sku` string, required — Identificador do produto
    - `value_of` number, float, required — Valor base de referência do produto
    - `value_per` number, float, required — Valor do produto com desconto
    - `quantity` number, float, required — Quantidade deste produto

## Response `200`

200

- object
  - `status` true | false — Status da ação
  - `message` string — Descritivo do `status`
  - `data` object — Corpo do retorno
    - `user_id` string — User ID hasheado. Se `""` = não existe
    - `request_pin` boolean — Indica se obriga acionar a rota `/pin/validate`
    - `text_pin` string — Se o canal de envio do PIN é SMS, retorna o conteúdo do SMS enviado ao consumidor. Se WhatsApp, apenas indica *Mensagem enviada Via WhatsApp*.

## Other responses

- `400` — 400

---

[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/revisions/7f3ebb042f1a/schema)