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:

1
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:

1
"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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "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
    }
  }
}