Sugestões

Itaú Shopline

A Itaú Shopline executa a aquisição de dados sigilosos do usuário no ambiente do Itaú. Assim, não é necessário ter cuidado no tráfego de tais dados.

Para saber mais sobre o ambiente de testes, consulte a página Ambiente de testes (Sandbox).

Configurações no ambiente do Itaú Shopline

Para o Gateway de Pagamento funcionar corretamente, é necessário configurar o domínio da url de retorno no ambiente do Itaú Shopline. Ele deve apontar para o domínio da api do Gateway de Pagamentos da Locaweb:


Domínio de produção:
https://api.gatewaylocaweb.com.br/
Domínio de Sandbox:
https://api-sandbox.gatewaylocaweb.com.br/

Url de Acesso

Esse meio utilizará o conceito de "Url de Acesso". O fluxo deve ser:

  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.

O nó "transação" deverá conter uma url de retorno. O usuário será redirecionado para essa url após ter preenchido os dados no ambiente do Itaú Shopline, no caso de sucesso ou de erro:

  "url_retorno":"http://www.sualoja.com.br/retorno"

Após a criação da transação pela API, você terá como resposta um JSON contendo o nó "url_acesso", como no exemplo abaixo:

Após a criação, armazene o id

  {
    "transacao":{
      "id":152,
      "status":"aguardando pagamento",
      "meio_pagamento":"itau_shopline",
      "numero_pedido":943,
      "url_acesso":"https://api.gatewaylocaweb.com.br/v1/itau_shopline/5ec36353-af33-420c-bdfb-18d7a3f08d61",
      "detalhes":{
        "nsu":null,
        "tipo_pagamento":null,
        "data_pagamento":null,
        "numero_autorizacao":null,
        "tipo_cartao":null
      }
    }
  }

Após o preenchimento dos dados, o usuário será redirecionado para a url_retorno e você deverá executar a operação de consulta passando o id da transação (que é retornado como um parâmetro quando o usuário é redirecionado para a página de retorno). O retorno será o novo status da transação e os dados adicionais.

Operações de Teste

Para mais detalhes, veja a página Ambiente de Testes (Sandbox).

Formato do retorno

O retorno desse convênio se assemelha ao seguinte exemplo:

{
  "transacao": {
    "id": 151,
    "status": "aguardando pagamento",
    "meio_pagamento": "itau_shopline",
    "numero_pedido": 123,
    "url_acesso": "https://api.gatewaylocaweb.com.br/v1/itau_shopline/c4d7693a-8de1-4279-8e36-11a336662d6c",
    "detalhes": {
      "nsu": null,
      "tipo_pagamento": null,
      "data_pagamento": null,
      "numero_autorizacao": null,
      "tipo_cartao": null
    }
  }
}