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:
-
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.
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 } } }