Configuração de Roteamento em Lote

Visão Geral#

A alteração ou configuração de roteamento em lote pode ser utilizada quando um grupo de lojas deseja mudar o roteamento das bandeiras para as adquirentes em somente parte de suas lojas ou quando o número de lojas torna inviável configurar uma a uma manualmente.

Desta forma, por exemplo, um grupo com 800 lojas onde todas roteiam as bandeiras Visa e Mastercard pela Cielo, deseja fazer com que somente 100 de suas lojas roteiem Visa por Rede.

Pré-requisitos#

Como pré-requisito as lojas e autorizadoras (bandeiras) que terão o roteamento alterado já devem estar cadastradas no Pagamento Online. Caso não estejam, consulte a documentação Cadastros de Lojas em Lote.

Lembrando que os roteamentos e bandeiras devem estar configurados no SiTef, para isso entre em contato com a nossa equipe de suporte Pagamento Online para garantir o funcionamento em produção.

Roteamentos/Rede adquirentes suportadas#

Os roteamentos suportados na operação de configuração em lote são:

  • Cielo via SiTef
  • Rede via SiTef
  • GetNet via SiTef
  • Stone WS

Formato do Arquivo de Importação#

ATENÇÃO: O arquivo de importação deve ser gerado com codificação UTF-8.

O arquivo será composto pelo o código da loja seguido pela bandeira que se deseja alterar e a rede por qual a bandeira será roteada, repetindo uma linha por bandeira, uma ou mais linhas por loja.

Somente serão alterados os roteamentos declarados no arquivo, se a loja possuir outras bandeiras não especificadas sua configuração será mantida.

Formato a ser recebido (formatação por linha):

campo1;campo2;campo3;parametro1|parametro2|...|parametroN
CampoDescriçãoFormatoObrigatório
campo1CNPJ (ou código loja, ou merchantId) não formatado (apenas números)< 15 ANSim
campo2Código da Autorizadora (bandeira). Consulte os códigos na seção Códigos de Autorizadoras/Bandeiras< 15 NSim
campo3Código da Rede Adquirente (Roteamento/Tipo de Pagamento). Consulte os códigos na seção Códigos de Rede Adquirentes/Roteamentos< 15 NSim
parametro1, parametro2, parametroNCampos para informações adicionais que variam de acordo com a rede adquirente/roteamento.-Não

Códigos de Autorizadoras/Bandeiras#

Bandeira/AutorizadoraCódigo
VISA1
MASTERCARD2
AMERICAN EXPRESS (AMEX)3
HIPERCARD5
AURA6
CABAL12
VALECARD28
SOROCRED29
DINERS33
ELO41
GOODCARD42
JCB43
DISCOVER44
CHINA UNION PAY45
CREDZ46
AGIPLAN47
VEROCHEQUE48
PAN122
AVISTA CREDITO192

Códigos de Rede Adquirentes/Roteamentos#

Roteamento/Tipo de PagamentoCódigo
Cielo via SiTef1125
Rede (antiga Redecard) via SiTef1005
GetNet via SiTef1181
e-Rede1200
Stone WS409

Parâmetros Adicionais#

Alguns roteamentos/tipos de pagamento requerem parâmetros adicionais cadastrados no sistema para realizar transações. Para informá-los preencha o campo 4 em diante de uma linha no seguinte formato:

...;chave1:valor1|chave2:valor2|chave3X:valorX

Os parâmetros adicionais não são obrigatórios, quando não forem enviados, serão definidos com um valor padrão.

Stone WS#

O roteamento Stone WS se refere à plataforma de e-commerce da adquirente Stone.

São requeridos os seguintes parâmetros adicionais para realizar suas funcionalidades:

CampoDescrição
salesAffiliationKeyIdentificação do estabelecimento comercial (loja) na adquirente Stone.
subAdquirenciaHabilitadaValores possíveis: true ou false. Este valor deve estar de acordo com as configurações do estabelecimento comercial (loja) na adquirente Stone em relação à subadquirência.

NOTA

Para o uso da subadquirência Stone WS, é necessário que os registros de cadastro do estabelecimento comercial (loja) estejam completos, ou seja, é preciso que os campos País, Cidade, Estado e CEP sejam informados corretamente no cadastro da loja no Pagamento Online. Verifique com a equipe de suporte Pagamento Online antes de solicitar uma mudança para Stone utilizando a subadquirência com SoftDescriptor. Para mais detalhes acesse a documentação da Stone WS.

Exemplo Stone WS#

22222222222222;1;409;salesAffiliationKey:XXXXXXXXXX|subAdquirenciaHabilitada:true

Exemplo#

Todas as lojas do grupo XPTO transacionam inicialmente com as bandeiras Visa, Mastercard, Hiper e Amex roteadas pela Rede.

Estado inicial do Grupo XPTO, incluindo lojas 11111111111111, 22222222222222 e 333333333333333:

BandeiraAdquirente
VisaRede (antiga Redecard)
MastercardRede (antiga Redecard)
HiperRede (antiga Redecard)
AmexRede (antiga Redecard)

É desejado que apenas duas lojas desse grupo, de código 11111111111111 e 22222222222222 passem a transacionar ambas com Visa via Cielo, e Mastercard via Stone WS, mantendo os roteamentos da Amex e Hiper sem alteração.

Lojas 11111111111111 e 22222222222222 após a mudança:

BandeiraAdquirente
VisaCielo
MastercardStone WS
HiperRede (antiga Redecard) -> Não muda
AmexRede (antiga Redecard) -> Não muda

E também é desejado mudar a loja de código 333333333333333 para transacionar Visa via Cielo e Amex via Stone WS, conforme abaixo.

Loja 333333333333333 após a mudança:

BandeiraAdquirente
VisaCielo
MastercardRede (antiga Redecard) -> Não muda
HiperRede (antiga Redecard) -> Não muda
AmexStone WS (com subadquirência)

O arquivo final a ser gerado será como o apresentado abaixo:

11111111111111;1;1125;
11111111111111;2;409;salesAffiliationKey:ABC123DEF456|subAdquirenciaHabilitada:false
22222222222222;1;1125;
22222222222222;2;409;salesAffiliationKey:ABC123DEF457|subAdquirenciaHabilitada:false
33333333333333;1;1125;
33333333333333;3;409;salesAffiliationKey:ABC123DEF458|subAdquirenciaHabilitada:true

ATENÇÃO: Caso o campo 4 seja vazio, não esquecer de finalizar a linha com ponto e vírgula ";".