Cadastrar provedores de pagamento e antifraude

Configurações de Pagamentos

Com a VTEX, você pode realizar a configuração de diversos provedores: gateways, adquirentes, subadquirentes, orquestradores, PSPs, entre outros. Estes lhe permitem oferecer diferentes métodos e condições de pagamentos aos seus clientes, bem como serviços de proteção de antifraude. Anteriormente, essas configurações eram conhecidas em nosso sistema como afiliações de gateway.

Por meio da tela de gerenciamento de provedores você pode:

Cadastrar um novo provedor
Visualizar provedores cadastrados
Editar configurações de provedores

${"base64":" ","img":{"width":1524,"height":664,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":78945,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_1.JPG"}}$

Cadastrar provedor

Para adicionar um novo provedor de pagamento ou antifraude em sua loja, siga os passos abaixo:

No Admin VTEX, acesse Configurações > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
Clique em Novo provedor.
Clique no provedor de pagamento de sua preferência.
Preencha os campos Chave de aplicação e Token de aplicação com as informações fornecidas pelo provedor de pagamento.
Caso seja exibida uma mensagem de alerta indicando a necessidade de instalação do app, clique no botão Instalar app e siga as instruções de instalação. Esta mensagem é exibida somente para alguns tipos de afiliações de gateway.
Clique em Salvar.

Caso haja outros campos a serem preenchidos além do Chave de aplicação e Token de aplicação (Passo 6), o provedor deve ser configurado conforme tutorial específico. Para maiores informações, verifique a subseção Configurações de Pagamento.

As credenciais utilizadas para preencher os campos Chave de aplicação e Token de aplicação devem ser fornecidas pelo provedor de pagamentos para identificar a loja. Não devem ser utilizadas credenciais geradas no Admin, que se iniciam com vtexappkey-.

Para configurar os métodos de pagamento a serem processados pelo provedor de pagamento escolhido, acesse Condições de Pagamento.

Para definir condições especiais sobre os métodos de pagamento, acesse Configurar condições especiais de Pagamento.

${"base64":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAIAAAA7ljmRAAAACXBIWXMAABYlAAAWJQFJUiTwAAAAIklEQVR4nGPwBINzYMDw//9/ZWXloqIiaWlpEAciWVRUBABnKxGh104zFQAAAABJRU5ErkJggg==","img":{"src":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_2.JPG","width":1132,"height":764,"type":"jpg"}}$

Visualizar provedores cadastrados

A tela principal de gerenciamento de provedores, disponível no Admin VTEX em Configurações > Pagamentos > Provedores, exibe todos os provedores de pagamento ou antifraude cadastrados em uma loja. Para permitir o acesso rápido a informações de provedores específicos é possível realizar uma busca ou utilizar um filtro.

Buscar provedores

Para localizar provedores pelo nome, acesse a página de gerenciamento de provedores e digite o nome do provedor desejado.

${"base64":" ","img":{"width":1538,"height":337,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":37935,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_3.JPG"}}$

Filtrar provedores

Para selecionar a exibição de provedores por meio de filtros, acesse a página de gerenciamento de provedores e aplique um ou mais filtros indicados abaixo, conforme desejado.

Nome: selecione a exibição de provedores de pagamento por meio do nome, ativando a caixa de texto ou digitando na barra de busca do menu.

${"base64":" ","img":{"width":1517,"height":635,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":61005,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_4.JPG"}}$

Tipo: selecione a exibição de provedores de pagamento, antifraude ou ambos.

${"base64":" ","img":{"width":1530,"height":325,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":36672,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_5.JPG"}}$

Ambiente: selecione a exibição de provedores pelo tipo de ambiente de operação cadastrado (produção ou teste).

${"base64":" ","img":{"width":1512,"height":321,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":36801,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_6.JPG"}}$

Para remover os filtros aplicados e voltar a visualizar todos os provedores cadastrados na loja, clique no botão Limpar todos.

Editar configurações de provedores

Para editar configurações de provedores de pagamento ou antifraude já cadastrados na loja, siga os passos abaixo:

No Admin VTEX, acesse Configurações > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
Clique no provedor de pagamento ou antifraude desejado.
Na tela de configuração do provedor, clique em Editar.
Realize as modificações necessárias e clique em Salvar.

${"base64":" ","img":{"width":1133,"height":615,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":41990,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/Payments/Payment%20Settings/afiliacoes-de-gateway_7.JPG"}}$

Antes de realizar qualquer alteração na configuração de um provedor, como por exemplo: dados de autorização, modo de processamento ou tipo de reembolso, certifique-se de que as novas informações a serem inseridas não irão prejudicar o seu desempenho operacional na loja.