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:

1. 'Criar transação'

2. 'Redirecionar o usuário para a url de acesso'

3. 'Receber o usuário de volta na página de Retorno'

4. '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:

  {
    "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"
    }
  }