---
updatedAt: 2026-10-14T21:18:34.000Z
agentTools:
  siteIndex: https://docs.cielo.com.br/llms.txt
  projectIndex: https://docs.cielo.com.br/conectores/llms.txt
---

# Configuração de cartão de crédito em sandbox na Wake

Para configurar cartão de crédito em sandbox, é necessário configurar um conector **Custom**.

Para isso, clique em **Pagamentos** > **Conectores de Pagamentos**:

![Visual da tela para clicar em conectores de pagamento ](https://files.readme.io/f4287afe259c9b0e4edf8fb90344438430cec2fa32183f4e924204232c061265-image.png)

Localize o conector **Custom** e clique em **NOVA CONFIGURAÇÃO**:

![Visual da tela para localizar o conector Custom e realizar a nova configuração](https://files.readme.io/1f20df40d4e522bf5f0e9582d151204bc64c5831d03627c8d5a2968b5de9d121-image.png)

Nomeie a configuração, recomendamos algo como "Cielo - Cartão sandbox", para fácil reconhecimento. A forma de pagamento será **Customizado**. Clique em **ADICIONAR CONFIGURAÇÃO**:

Em **Configuração do Endpoint de Pagamento**, insira:

* **Url**: `https://paymentconnectorwakesandbox.cieloecommerce.cielo.com.br/api/credit`
* **Versão**: Completa

Em **Headers**, insira as chaves e os valores conforme a tabela:

<Callout icon="ℹ️" theme="info">
  Clique em **ADICIONAR HEADER** para adicionar mais chaves.
</Callout>

<Image align="center" alt="Visual da tela para Adicionar Header" src="https://files.readme.io/c50ffd95d09ab3dd1e896510532f4797c04befbaf0b14fc20e15962f48d5f07a-wake_2.png" />

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Campo
      </th>

      <th>
        Valor
      </th>

      <th>
        Obrigatório
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `MerchantId`
      </td>

      <td>
        Insira o identificador da loja.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `MerchantKey`
      </td>

      <td>
        Insira a chave de <Glossary>autenticação</Glossary>. A chave é diferente para os ambientes de sandbox e produção, inclua a chave de **sandbox**.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `SOPClientId`
      </td>

      <td>
        Insira a chave fornecida pela Cielo.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `SOPClientSecret`
      </td>

      <td>
        Insira a chave fornecida pela Cielo.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `Integration`
      </td>

      <td>
        Sempre será **Gateway**.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `SoftDescriptor`
      </td>

      <td>
        Insira o nome da loja que aparecerá na fatura do cliente.  
        Máximo de 13 caracteres incluindo espaços. Não aceita caracteres especiais.
      </td>

      <td>
        Não
      </td>
    </tr>

    <tr>
      <td>
        `SaveCard`
      </td>

      <td>
        Insira **True** caso tenha Cartão Protegido.  
        Insira **False** caso não tenha Cartão Protegido.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `Provider`
      </td>

      <td>
        Insira o nome do provedor. Para testes em Sandbox, insira "Simulado".
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `Antifraud`
      </td>

      <td>
        Se tiver Antifraude integrado, escolha o fluxo de análise de fraude que deseja:

        **AuthorizeFirst**: a transação passa pela <Glossary>autorização</Glossary> antes de chegar na análise de fraude.

        **AnalyseFirst**: a transação é analisada pelo Antifraude antes de ser autorizada.  
        Se não tiver Antifraude integrado, deixe o campo em branco.
      </td>

      <td>
        Sim, se usar Antifraude.
      </td>
    </tr>

    <tr>
      <td>
        `AntifraudSequenceCriteria`
      </td>

      <td>
        Se tiver Antifraude integrado, escolha a condição para análise de fraude:

        **OnSuccess**: a transação só será analisada pelo Antifraude se for autorizada.

        **Always**: a transação será analisada independentemente da<Glossary>autorização</Glossary>.  
        Se o fluxo escolhido em `Antifraud` for **AnalyseFirst**,`AntifraudSequenceCriteria` sempre será **Always**.  
        Se não tiver Antifraude integrado, deixe o campo em branco.
      </td>

      <td>
        Sim, se usar Antifraude.
      </td>
    </tr>

    <tr>
      <td>
        `AntifraudeProvider`
      </td>

      <td>
        Se tiver Antifraude integrado, escolha o provider da análise de fraude: **Cybersource** ou **Clearsale**.  
        Se não tiver Antifraude integrado, deixe o campo em branco.
      </td>

      <td>
        Sim, se usar Antifraude.
      </td>
    </tr>

    <tr>
      <td>
        `UseVerifyCard`
      </td>

      <td>
        **True**: caso use o Verifycard;

        **False**: caso não use o Verifycard.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `AcceptInternationalCard`
      </td>

      <td>
        **True**: caso permita pagamentos com cartões internacionais;

        **False**: caso não permita pagamentos com cartões internacionais.
      </td>

      <td>
        Sim, se usar VerifyCard.
      </td>
    </tr>

    <tr>
      <td>
        `AcceptPrePaidCard`
      </td>

      <td>
        **True**: caso permita pagamentos com cartão pré-pago;

        **False**: caso não permita pagamentos com cartão pré-pago.
      </td>

      <td>
        Sim, se usar VerifyCard.
      </td>
    </tr>

    <tr>
      <td>
        `CustomMdds`
      </td>

      <td>
        Campo aberto para envio de MDDs customizados. Veja a <a href="https://wakecommerce.readme.io/docs/payment" target="_blank">documentação da Wake</a> para mais detalhes.  
        Envie no formato licar em;conectores de pagamento ](https:  
        Exemplo: 85;total
      </td>

      <td>
        Não
      </td>
    </tr>

    <tr>
      <td>
        `MpiClientId`
      </td>

      <td>
        Insira a credencial fornecida pela Cielo para uso do 3DS.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `MpiClientSecret`
      </td>

      <td>
        Insira o token fornecido pela Cielo para uso do 3DS.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `MpiMerchantName`
      </td>

      <td>
        Insira o nome da loja para o 3DS.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `UseMPI`
      </td>

      <td>
        **True**: se usar o 3DS (autenticável ou DataOnly);

        **False**: se não usar nenhum processo do 3DS.
      </td>

      <td>
        Sim
      </td>
    </tr>

    <tr>
      <td>
        `MpiEstablishmentCode`
      </td>

      <td>
        Insira o número de EC fornecido pela Cielo para uso do 3DS.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `MpiMCC`
      </td>

      <td>
        Insira o MCC da loja fornecido pela Cielo para uso do 3DS.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `DataOnly`
      </td>

      <td>
        **True**: se usar o 3DS exclusivamente para DataOnly;

        **False**: se usar o 3DS autenticável.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `MpiCancelOnFailure`
      </td>

      <td>
        Define o comportamento quando ocorre erro na **primeira etapa** (autenticação 3DS).

        * **True**: cancela transações com falha na autenticação 3DS;
        * **False**: mantém transações mesmo com falha na autenticação 3DS.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>

    <tr>
      <td>
        `MpiCancelOnECIDowngrade`
      </td>

      <td>
        Define o comportamento quando ocorre falha ou downgrade na **segunda etapa** (validação durante a autorização).

        * **True**: cancela transações com falha na validação da autenticação durante a autorização;
        * **False**: mantém transações mesmo com falha na validação da autenticação durante a autorização.
      </td>

      <td>
        Sim, se usar autenticação 3DS.
      </td>
    </tr>
  </tbody>
</Table>

> ℹ️ Quando usar `MpiCancelOnFailure` e `MpiCancelOnECIDowngrade`
>
> Os campos relacionados ao 3DS atuam em pontos diferentes do fluxo de autenticação:
>
> * `MpiCancelOnFailure`: gerencia falhas na primeira etapa, quando o cliente insere o OTP (autenticação inicial);
> * `MpiCancelOnECIDowngrade`: gerencia falhas ou downgrade na segunda etapa, quando o emissor valida a autenticação durante a autorização.

Confira os campos a serem preenchidos para **Antifraude integrado**, **Antifraude personalizado** e **sem Antifraude**:

* **Antifraude integrado:** preencha os campos `Antifraud`, `AntifraudSequenceCriteria` e `AntifraudeProvider`, e selecione "Nenhum" no campo `Antifraude`.
* **Antifraude personalizado:** deixe os campos em branco ou com um espaço (" ") e selecione "Personalizado" no no campo `Antifraude`.
* **Sem antifraude:** deixe os campos em branco e selecione "Nenhum" no campo `Antifraude`.

<Callout icon="⚠️" theme="warn">
  Selecione **Nenhum** no campo `Antifraude`, mesmo que você vá utilizar o Antifraude integrado com Gateway de Pagamento.
</Callout>

> O conector não é case sensitive.

Na tela preta de código, inclua o HTML:

```
<b>Crédito</b>
<div data-gateway-cartao>
<div class='forminline'>
<input type="hidden" name="bandeira"/>
</div>
</div>

```

Clique em **Atualizar** para salvar a configuração. Caso não seja possível salvar por conta dos campos em branco, digite dois espaços e tente atualizar novamente.

Se tiver Antifraude integrado, siga para a [configuração do Antifraude](https://docs.cielo.com.br/conectores/docs/antifraude-sand).

Se não tiver Antifraude integrado, siga para a [ativação do meio de pagamento](https://docs.cielo.com.br/conectores/docs/ativar-pagamentos).