Banrisul Vero
A loja tem a possibilidade de configurar o roteamento de transações feitas no e-SiTef por vários meios de pagamento, um desses meios é o Banri Compras, plataforma de pagamentos do banco Banrisul para e-commerce, desenvolvida pela rede Banrisul Vero.
Interfaces e-SiTef suportadas para integração
É possível utilizar as seguintes interfaces para a integração com o roteamento Banrisul Vero:
- Pagamento HTML
Credenciais necessárias
Para começar a transacionar com a Banrisul Vero, a loja deve obter o código de Rede, código de Estabelecimento e Senha de acesso para integração no ambiente da Banrisul Vero. Para isso, a loja deve solicitar sua credencial de acesso através do e-mail: srac@banrisul.com.br
Após recebimento, o lojista deve encaminhar o código de Estabelecimento e o código de Rede para a equipe produção da Software Express. Esses dados podem ser cadastrados também no Portal do Lojista do e-SiTef no item de menu "Configurar Autorizadoras".
A senha de acesso ao portal Banri Compras deve ser obrigatoriamente cadastrada pelo lojista no Portal do Lojista do e-SiTef. Este dado é importante para que o e-SiTef informe o status atualizado das transações efetuadas no Banri Compras na conta do lojista.
| Campo | Descrição |
|---|---|
codigoEstabelecimento | Identificação do estabelecimento no Banrisul Vero. |
codigoRede | Identificação da rede no Banrisul Vero. |
senha | Senha de acesso ao Portal Banri Compras. |
Parâmetros de requisição
A Banrisul Vero permite que sejam realizadas três modalidades de pagamento: à vista, parcelado ou pré-datado.
Todas as modalidades de pagamento acima são realizadas somente via transferência bancária.
Caso a opção escolhida for parcelada ou pré-datada, alguns parâmetros adicionais (additional_data.extra_param.params) devem ser enviados na requisição HTML como nos exemplos abaixo.
Saiba mais sobre a interface HTML.
À vista
Nenhum dado adicional é necessário nos casos de pagamentos à vista. O código de autorizadora (authorizer_id) é 411.
Exemplo de requisição
{
"merchant_id":"BANRICOMPRAS",
"order_id":"09024709605",
"authorizer_id":"411",
"amount":"1000"
}
Parcelado
| Campo | Descrição | Formato |
|---|---|---|
bank_installments | Número de parcelas totais. Para a Banrisul Vero, este campo será utilizado no lugar do campo installments. | 2 N |
installment | Campo que informa quais parcelas serão pagas. Devem ser informadas no formato NN. Exemplo: 0102 (serão pagas as parcelas um e dois). | 2 N a cada parcela |
deadline_option | Campo que informa se o prazo de pagamento das parcelas será informado em dias ou por uma data específica. Valores permitidos: D – Definido por uma data.P – Definido por um prazo em dias. | 1 A |
deadline_date | Caso seja escolhida a opção D para o campo deadline_option, deve ser informado neste campo a data sugerida para o pagamento das parcelas.A data para cada parcela deve ser informada no formato AAAMMDD. Exemplo: 20181023 (23/10/2018).Ao informar a data de mais de uma parcela, concatenar as datas na ordem das parcelas. Exemplo: 2018102320181124 (para a primeira parcela a data é 23/10/2018 e para a segunda parcela 24/11/2018). | 8 N a cada parcela |
deadline_period | Caso seja escolhida a opção P para o campo deadline_option, deve ser informado neste campo o prazo sugerido para o pagamento das parcelas.O prazo para cada parcela deve ser informado no formato NNN. Exemplo: 030 (30 dias de prazo para o pagamento da parcela).Ao informar o prazo de mais de uma parcela, concatenar os prazos na ordem das parcelas. Exemplo: 030060 (para a primeira parcela o prazo é de 30 dias e para a segunda parcela 60 dias). | 3 N a cada parcela |
installments_amount | Informa o valor de cada parcela a ser paga. O valor das parcelas deve ser informado no formado 15 N. Exemplo: 000000000005000 (50 reais).Ao informar o valor de mais de uma parcela, concatenar os valores na ordem das parcelas. Exemplo: 000000000005000000000000006000 (para a primeira parcela o valor é de 50 reais e para a segunda parcela 60 reais). | 15 N a cada parcela |
Exemplo de requisição
{
"merchant_id":"BANRICOMPRAS",
"order_id":"09035003921",
"authorizer_id":"412",
"amount":"1000",
"additional_data":{
"extra_param":{
"params":[
{
"key":"bank_installments",
"value":"02"
},
{
"key":"deadline_option",
"value":"P"
},
{
"key":"installment",
"value":"0102"
},
{
"key":"deadline_date",
"value":""
},
{
"key":"deadline_period",
"value":"000030"
},
{
"key":"installments_amount",
"value":"000000000000500000000000000500"
}
]
}
}
}
Pré-datado
| Campo | Descrição | Formato |
|---|---|---|
bank_installments | Obrigatoriamente 01. | 2 N |
installment | Obrigatoriamente 01. | 2 N |
deadline_option | Campo que informa se o prazo de pagamento das parcelas será informado em dias ou por uma data específica. Valores permitidos: D – Definido por uma data.P – Definido por um prazo em dias. | 1 A |
deadline_date | Caso seja escolhida a opção D para o campo deadline_option, deve ser informado neste campo a data sugerida para o pagamento da parcela.A data para cada parcela deve ser informada no formato AAAMMDD. Exemplo: 20181023 (23/10/2018).ATENÇÃO: Caso seja escolhida a opção P para o campo deadline_option, fixar o valor 00000000 neste campo. | 8 N |
deadline_period | Caso seja escolhida a opção P para o campo deadline_option, deve ser informado neste campo o prazo sugerido para o pagamento das parcelas.O prazo para cada parcela deve ser informado no formato NNN. Exemplo: 030 (30 dias de prazo para o pagamento da parcela). | 3 N |
installments_amount | Informa o valor de cada parcela a ser paga. O valor das parcelas deve ser informado no formado 15 N. Exemplo: 000000000005000 (50 reais). | 15 N |
Exemplo de requisição
{
"merchant_id":"BANRICOMPRAS",
"order_id":"09024709605",
"authorizer_id":"413",
"amount":"5000",
"additional_data":{
"extra_param":{
"params":[
{
"key":"bank_installments",
"value":"01"
},
{
"key":"deadline_option",
"value":"P"
},
{
"key":"installment",
"value":"01"
},
{
"key":"deadline_date",
"value":"00000000"
},
{
"key":"deadline_period",
"value":"030"
},
{
"key":"installments_amount",
"value":"000000000005000"
}
]
}
}
}
Fluxo de Pagamento HTML
Ao realizar uma transação Banrisul Vero, o seguinte fluxo de telas será iniciado:
Saiba mais sobre a interface HTML.
Ao clicar no botão "ACESSAR BANCO" o comprador será redirecionado para o ambiente da Banri Compras:
Ao finalizar o processo de pagamento no ambiente da Banri Compras, o pagador será redirecionado para a página de fracasso ou sucesso que estão configuradas no portal da Banrisul. O próximo capítulo apresenta mais detalhes sobre a configuração de URL's.
Configuração de URL's de redirecionamento
Para realizar o cadastro de URL's de redirecionamento, deve-se acessar o Portal da Banrisul:
http://ww4.banrisul.com.br/banricompras/LINK/logon/Index.asp?info=true
Ao entrar com as credenciais de acesso, a seguinte tela será exibida:
Clique em páginas de aviso de operação para usuário e configure as URL's para as quais o pagador será redirecionado ao final do pagamento no ambiente Banri Compras:
Configurações de tempo no e-SiTef
O e-SiTef tem configurado por padrão alguns tempos relacionados a pagamentos Banrisul Vero:
| Descrição | Valor padrão |
|---|---|
| Tempo para timeout de chamadas do e-SiTef ao Sistema Banrisul Vero | 60 segundos |
| Máximo de dias que o e-SiTef efetua consulta de transações pendentes no Sistema Banrisul Vero | 15 dias |
| Intervalo de tempo em segundos entre consultas de transações pendentes no Sistema Banrisul Vero | 60 segundos |
| Quantidade máxima de consultas de transações pendentes no Sistema Banrisul Vero | 10 consultas |
Atenção: os valores descritos acima são apenas para referência inicial. Consulte a equipe de atendimento do e-SiTef para ter os valores exatos configurados no ambiente.