Integrando o Bcash em sua loja virtual

Como enviar um Pedido para o Bcash?

Quando o consumidor concluir a compra na loja virtual, os dados da compra deverão ser enviados (via POST) para a URL de checkout Bcash. Em seguida o consumidor será direcionado para o checkout Bcash onde poderá escolher a forma de pagamento e realizar o pagamento da transação.

Abaixo seguem algumas informações básicas sobre a integração:

  • Formato: não possui linguagem especifica (Exemplo: HTML, PHP, JavaScript, Ruby e entre outros).
  • Encoding: ISO-8859-1
  • Natureza de requisição: Envio (request)
  • Método: POST
  • URI: https://www.bcash.com.br/checkout/pay

Exemplo de envio do POST para a URL do checkout Bcash:

<form name=&quot;bcash&quot;action=&quot;https://www.bcash.com.br/checkout/pay/&quot;method=&quot;post&quot;>

<!-- Identificação do vendedor -->;

<input name=&quot;email_loja&quot; type=&quot;hidden&quot; value=&quot;sualoja@sualoja.com.br&quot;>

<!-- Dados do Pedido / Produtos -->

<input name=&quot;produto_codigo_1&quot;type=&quot;hidden&quot;value=&quot;1001&quot;>

<input name=&quot;produto_descricao_1&quot; type=&quot;hidden&quot;value=&quot;Camisa Seleção Brasileira&quot;>

<input name=&quot;produto_qtde_1&quot; type=&quot;hidden&quot; value=&quot;1&quot;>

<input name=&quot;produto_valor_1&quot;type=&quot;hidden&quot;value=&quot;250.00&quot;>

<!-- Dados do Comprador -->

<input name=&quot;email&quot;type=&quot;hidden&quot;value=&quot;email.comprador@dominio.com.br&quot;>

<input name=&quot;nome&quot;type=&quot;hidden&quot;value=&quot;Nome do Comprador&quot;>

<input name=&quot;cpf&quot;type=&quot;hidden&quot;value=&quot;67882081744&quot;>

<input name=&quot;telefone&quot;type=&quot;hidden&quot;value=&quot;1126267469&quot;>

<!-- Dados de Entrega -->

<input name=&quot;cep&quot; type=&quot;hidden&quot;value=&quot;04001001&quot;>

<input name=&quot;endereco&quot;type=&quot;hidden&quot;value=&quot;Av. Paulista, 1070&quot;>

<input name=&quot;cidade&quot;type=&quot;hidden&quot;value=&quot;São Paulo&quot;>

<input name=&quot;estado&quot;type=&quot;hidden&quot;value=&quot;SP&quot;>

<input type=&quot;image&quot;src=&quot;https://www.bcash.com.br/webroot/img/bt_comprar.gif&quot; value=&quot;Comprar&quot;alt=&quot;Comprar&quot;border=&quot;0&quot;align=&quot;absbottom&quot;>

</form>

Tabela de parâmetros.

Parâmetros Obrigatório Exemplo Descrição Tamanho

Dados do Vendedor

email_loja Sim sualoja@sualoja.comoom.br E-mail cadastrado no Bcash. 80

Dados do Pedido

produto_codigo_1 Sim 1001 Código que identifica o produto em sua loja. 50
produto_descricao_1 Sim Camisa Seleção Brasileira Descrição ou nome do produto. Essa informação será visualizada pelo comprador. 255
produto_qtde_1 Sim 1 Quantidade comprada deste produto. 11
produto_valor_1 Sim 250.00 Valor unitário do produto. Usar ponto (.) para separar os decimais. 11
Atenção: o “1” em vermelho nos campos acima caracteriza as informações do primeiro produto, caso o pedido possua dois ou mais produtos, os mesmos deverão obrigatoriamente ser informados da mesma maneira, porém, o número “1” deverá ser substituído por “2”, “3” e assim sucessivamente.

Dados da Entrega

cep Sim 04001001 CEP do comprador 9
endereco Sim Av. Paulista, 123 Endereço do comprador 100
bairro Não Bela Vista Bairro do comprador 50
cidade Sim São Paulo Cidade do comprador 255
estado Sim SP Estado do comprador 2
complemento Não Apartamento Complemento do comprador 80
         

Dados do Comprador

email Sim email.comprador@dominio.com.br E-mail do comprador 80
nome Sim Nome do Comprador Nome do comprador 80
cpf Sim 67882081744 CPF do comprador 17
telefone* Sim 1126267469 Telefone do comprador 20
celular* Sim 11926267469 Celular do comprador 20
cliente_razao_social ** Sim Nome Razão Social Razão Social do comprador 255
cliente_cnpj ** Sim 67882081000144 CNPJ do comprador 30
sexo Não M Sexo do comprador 1
data_nascimento Não 01/01/1234 Data de nascimento do comprador 10
rg Não 123456789 RG do comprador 20
data_emissao_rg Não 01/01/1234 Data de emissão do RG 10
orgao_emissor_rg Não SSP Órgão emissor do RG 20
estado_emissor_rg Não SP Estado onde foi emitido o RG 2
         
*Basta enviar um dos campos, ou seja Telefone ou celular.

**Campo necessário apenas quando comprador for “Pessoa Jurídica”.

         
Observação: Mesmo enviando os campos necessários para o cadastro de “Pessoa Jurídica”, o comprador poderá se cadastrar como “Pessoa Física”. Essa escolha será feita pelo comprador em nosso checkout.
         
Atenção: Os campos marcados com “X” são informações necessárias para que uma transação seja finalizada. Enviando-as o comprador não terá que as preenche-las novamente em nosso sistema, o que torna a experiência de compra melhor e aumenta a conversão de vendas da loja virtual.

Campos Adicionais

Parâmetro Formato Tamanho Descrição
url_retorno Alfanumérico 255 URL que indica uma página em sua loja virtual para onde o comprador será direcionado após finalizar o pagamento e que também poderá receber as atualizações de status das transações, caso escolha esse tipo de integração para o Retorno automático dos dados.
url_aviso Alfanumérico 255 URL que indica uma página em sua loja virtual que receberá as atualizações de status das transações, caso escolha esse tipo de integração para o Retorno automático dos dados.
redirect Alfanumérico 10 Este campo ativa uma contagem regressiva de 30 segundos que redirecionará automaticamente o comprador para a URL informada no campo “url_retorno”.

 

Basta informar o valor “true” no campo “redirect” que a contagem regressiva será iniciada automaticamente.

redirect_time Numérico 2 Utilizado para definir os segundos que a contagem regressiva terá até que o comprador seja redirecionado para a URL de Retorno (“url_retorno”).

 

Valores permitidos: 0 a 60 (segundos). Para o redirecionamento imediato, use 0. Se este parâmetro vier vazio ou inválido, o Bcash irá considerar o tempo padrão de 30 segundos.

hash Alfanumérico 255 Permite criar uma instrução criptografada das informações enviadas ao Bcash através do código html, garantindo a integridade dos dados.
desconto Numérico 11 Valor total do desconto atribuído pela loja. Usar “.” para separar os decimais (Enviar o valor que será descontado e não a porcentagem).
acrescimo Numérico 11 Valor total do acréscimo feito pela loja. Usar ponto “.” para separar os decimais (Enviar o valor que será acrescido e não a porcentagem).
parcela_maxima Numérico 2 Limitará o número máximo de parcelas que a loja aceitará.
meio_pagamento Numérico 2 Pré-seleção dos meios de pagamento.

 

Ao informar nesse campo o código do meio de pagamento escolhido pelo comprador, o Bcash já trará selecionado o meio de pagamento escolhido.

id_plataforma * Numérico 5 Identificação da Plataforma desenvolvedora da Loja Virtual.
free Alfanumérico 255 Campo de Livre Digitação.
email_dependente_x Alfanumérico 80 E-mail do comissionado.
valor_dependente_x Numérico 50 Valor que o comissionado irá receber. Usar ponto “.” para separar os decimais (Enviar o valor da comissão e não a porcentagem).
       
* O envio do “id_plataforma” torna-se obrigatório para a identificação das plataformas parceiras

 

Atenção: Não deixe de verificar a sessão “Atualizando o status do pedido em minha loja virtual com o Bcash”, esse é recurso oferecido pelo Bcash para notificar a loja virtual sobre os status das transações. Essas notificações são enviadas sempre que uma nova transação é criada ou quando há uma alteração de status da mesma e com esse recurso, o lojista poderá acompanhar as transações diretamente na área administrativa da loja virtual, não sendo necessário acessar sua conta do Bcash para verificar os status das transações.