---
updatedAt: 2026-08-26T16:53:52.000Z
agentTools:
  projectIndex: https://developer.pagbank.com.br/llms.txt
---

# Connect via SMS

Para utilizar a autorização através do Connect SMS é necessário que o usuário esteja cadastrado no PagBank.

## Passos de utilização

Os passos relacionados ao processo de autorização usando o Connect SMS são apresentados nesta página.

### 1. Solicite a autorização

Para solicitar autorização de forma transparente, sem redirecionar o vendedor para o ambiente do PagBank, você precisará informar a agenda e conta do usuário cadastrado no PagBank. Com o e-mail do usuário e as informações da sua applicação (`X_CLIENT_ID` e `X_CLIENT_SECRET`), utilize o endpoint [Solicitar autorização via SMS](https://developer.pagbank.com.br/devpagbank/reference/solicitar-autorizacao-via-sms). A imagem a seguir exemplifica esse passo:

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/93d05524d189bf0fafe4873ea118397f0649ee6f2ff107c25e96a8fed6adbb2d-Novo_fluxo_connect_sms.png",
        null,
        ""
      ],
      "align": "center",
      "sizing": "850px"
    }
  ]
}
[/block]

### 2. Confirmação pelo vendedor

O vendedor receberá o SMS de confirmação no seu telefone cadastrado contendo o `sms_code` que deve ser fornecido à sua aplicação.

### 3. Obtenha o access token

Utilize o código `sms_code` e o endpoint [Obter access token](https://developer.pagbank.com.br/devpagbank/reference/obter-access-token) para obter o `access_token` utilizado para autorizar operações futuras relacionadas a esse vendedor. Confira mais informações na seção [Access token](https://developer.pagbank.com.br/devpagbank/docs/connect#access-token).

Para melhorar a sua experiência de integração, o PagBank disponibiliza opções que permitem simular o processo de autorização com o Connect via SMS.

## Simule a autorização com Connect via SMS

Ao utilizar o ambiente Sandbox, você pode simular (*mock*) a autorização e receber respostas pré-definidas. Utilize essa opção para testar o comportamento do seu sistema frente a cenários específicos. Você pode utilizar essa opção para analisar a resposta do seu sistema frente a uma autorização com sucesso, por exemplo.

### Simular autorização via SMS

Para que você consiga simular cenários com o endpoint [Solicitar autorização via SMS](https://developer.pagbank.com.br/devpagbank/reference/solicitar-autorizacao-via-sms), você utilizará as informações disponibilizadas na próxima tabela para preencher os campos  `bank_branch` e `account_number`. As respostas do endpoint serão padronizadas de acordo com os dados fornecidos.

| Cenário     | Condição                                                            | Descrição de uso                                                                      |
| :---------- | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------ |
| **Sucesso** | Solicitação criada.                                                 | Utilize os dados fixos nos campos `bank_branch: 0001` e `account_number: 00000000-1`. |
| **Erro**    | Vendedor bloqueado por excesso de envio de SMS.                     | Utilize os dados fixos nos campos `bank_branch: 0001` e `account_number: 00000000-2`. |
| **Erro**    | Impossível enviar SMS para o telefone referente ao email informado. | Utilize os dados fixos nos campo `bank_branch: 0001` e `account_number: 00000000-3`.  |

### Simular obtenção do access token

Para que você consiga simular cenários com o endpoint  [Obter access token](https://developer.pagbank.com.br/devpagbank/reference/obter-access-token), você deverá utilizar os seguintes `sms_code` ao realizar a requisição:

| Cenário     | Condição                                                                   | Descrição de uso                                    |
| :---------- | :------------------------------------------------------------------------- | :-------------------------------------------------- |
| **Sucesso** | Obtem o access token para o e-mail utilizado na solicitação da atorização. | Ao criar a requisição, utilize`sms_code = 123456`.  |
| **Erro**    | Bloqueio por excesso de tentativas SMS.                                    | Ao criar a requisição, utilize `sms_code = 200200`. |