Cielo Buy Page Cielo
O “Cielo Buy Cielo” consiste da captura dos dados do cartão dentro do ambiente da cielo, te isentando de maiores cuidados no tráfego desses dados. Para utilização da Cielo com a captação de dados pela cielo, é necessário que seu contrato com a cielo reflita essa opção, para maiores informações sobre essa modalidade de contrato consulte a documentação acerca da contratação no link: Contratar um Meio de Pagamento.
Esse meio utilizará o conceito de “Url de Acesso” , tendo o fluxo:
-
'Criar transação'
-
'Redirecionar o usuário para a url de acesso'
-
'Receber o usuário de volta na página de Retorno'
-
'Consultar a transação após o retorno do usuário'
Esta modalidade não permite que você envie os dados do cartão , sendo assim o nó “pagamento” a ser enviado não deve conter os dados do cartão(somente a bandeira), ficando parecido com a estrutura abaixo:
"pagamento":{ "meio_pagamento":"cielo", "bandeira": "visa", "parcelas":"1", "tipo_operacao":"credito_a_vista" }
Além disso o nó transação deverá conter uma url de retorno para onde o usuário será redirecionado após ter preenchido os dados no ambiente da cielo em caso de sucesso e de erro respectivamente:
URL Retorno
Após o preenchimento dos dados, o usuário será redirecionado para a url_retorno deverá executar a Operação de consulta passando o id da transação, onde terá como retorno o novo status da transação e os dados adicionais:
Exemplo:"url_retorno":"http://www.minha-loja.com/url-retorno"
Requisição/Resposta Cielo Buy Page Cielo:
Segue abaixo um exemplo do corpo da requisição usando o Buy Page Cielo:
{ "token":"3a5bbed0-50d4-012f-8d73-0026bb5a6240", "transacao":{ "url_retorno":"http://www.sualoja.com.br/retorno", "capturar":"true", "pedido":{ "numero":"6512", "total":"7630.00", "moeda":"real", "descricao":"Carrinho de Compras" }, "pagamento":{ "bandeira":"visa", "meio_pagamento":"cielo", "parcelas":"1", "tipo_operacao":"credito_a_vista" }, "comprador":{ "nome":"Nome do comprador", "documento":"12345678900", "endereco":"Rua da Casa", "complemento":"Ap 82", "numero":"1", "cep":"09710240", "bairro":"Centro", "cidade":"São Paulo", "estado":"SP" } } }
Depois de realizada a criação de uma transação usando Buy Page Cielo, o Gateway de Pagamentos da Locaweb retornará uma resposta semelhante:
{ "transacao" : { "status" : "aguardando_pagamento", "meio_pagamento" : "cielo", "numero_pedido" : 6512, "id" : 163, "detalhes" : { "arp" : null, "lr" : null, "nsu" : null, "pan" : null, "tid" : "10017348980825651001" }, "erro" : null, "total" : "7630.00", "url_acesso" : "https://qasecommerce.cielo.com.br/web/index.cbmp?id=b817bc2ed8ac0009a1d6dc8199069b27" } }
Visitando a Url de Acesso
Redirecionando o usuário para a url de acesso, o usuário precisara digitar os dados do cartão:
Depois de confirmado a compra será passado o id da transacao na url de retorno passada:
http://www.sualoja.com.br/retorno?transacao=163
Com o id da transação sendo passado na url de retorno, você já pode Consultar a transação.
Segue abaixo um exemplo de como seria o retorno da Consulta da Transação:
Concluindo: Após a criação armazene o Id da transação , no caso “163”, e redirecione o usuário da sua loja para a “url_acesso” retornada, que é onde o usuário irá preencher os dados do cartão de crédito. Quando o usuário for redirecionado para url de retorno você deverá consultar a transação.
{ "transacao": { "status": "paga", "meio_pagamento": "cielo", "numero_pedido": 6512, "id": 163, "detalhes": { "arp": "765", "lr": "57", "nsu": "375755", "pan": "IqVz7P9zaIgTYdU41HaW/OB/d7Idwttqwb2vaTt8MT0=", "tid": "10017348980825651001" }, "erro": null, "total": "7630.00", "url_acesso": "https://qasecommerce.cielo.com.br/web/index.cbmp?id=b817bc2ed8ac0009a1d6dc8199069b27" } }
Operações de Teste
Para mais detalhes das operações de teste veja Ambiente de Testes
Formato do retorno
O Formato do retorno como todos os outros retornos da API será em formato Json e conterá o seguintes campos:
Campo | Descrição |
---|---|
id | Identificação da transação no Gateway de Pagamentos da Locaweb. |
total | Total da Transação criada no Gateway de Pagamentos da Locaweb. |
status | Status da transação. |
url_acesso | Url que o usuário precisará ser redirecionado. Esse nó é retornado em alguns casos específicos, como por exemplo quando você configura a Cielo para ser autenticado |
meio_pagamento | Meio de pagamento utilizado na Transação criada no Gateway de Pagamentos da Locaweb. |
detalhes | Nó onde retorna informações específicas da Cielo. |
Segue abaixo as informações do nó de detalhes da Cielo:
Campo | Descrição |
---|---|
tid | O TID é o elo de ligação entre o pedido de compra da loja e a transação na Cielo. |
nsu | Número de sequência da autorização na Cielo. |
pan | Hash do número do cartão do portador na Cielo. |
arp | Código da autorização caso a transação tenha sido autorizada com sucesso. |
lr | Retorno da autorização na Cielo. Quando negada, é o motivo da negação. |
Exemplo de Retorno
{ "transacao": { "id" : 163, "status": "paga", "meio_pagamento" : "cielo", "numero_pedido" : 12345, "detalhes" : { "arp": "776655", "lr": null, "nsu": "998877", "pan": "887766", "tid": "10017348980826441001" }, "erro": null, "total": "189.00", "url_acesso": "https://qasecommerce.cielo.com.br/web/index.cbmp?id=671387a5190760b7c9e0fa8ccbaf72c4" } }