Gerenciar o diálogo com o site de e-commerce

A gestão do diálogo com o site de e-commerce é realizada graças a dois tipos de URL:

  • Url de notificação instantânea, também chamada IPN (Instant Payment Notification),
  • Url de retorno para o site de e-commerce.

Url de notificação instantânea - IPN (Instant Payment Notification)

A plataforma de pagamento notifica automaticamente o resultado do pagamento ao site de e-commerce. Os dados são enviados em modo POST.

A plataforma é capaz de entrar em contato com o site de e-commerce seja qual for o protocolo usado (http ou https).

As notificações são enviadas a partir de um endereço IP que consta na faixa 194.50.38.0/24 em modo de Teste e em modo de Produção.

Para tratar essas notificações, o estabelecimento deve criar uma página no seu site que:

  • analisa os dados recebidos em modo POST,
  • garante a integridade das informações recebidas calculando a assinatura,
  • verifica que não se trate de uma dupla notificação (reenvio da notificação desde o Back Office Estabelecimento Comercial por exemplo),
  • lança a atualização da sua base de dados (status do pedido, estoque, etc.),
  • envia e-mails para o comprador (fatura, acompanhamento de pedido, etc.).

O tempo de processamento impacta diretamente o prazo para a visualização da página de resumo do pagamento. Quanto mais o processamento demorar, mais longo o tempo de espera antes de visualizar.

Para receber as notificações, o Estabelecimento Comercial deve configurar as regras de notificações no seu Back Office Estabelecimento Comercial (ver capítulo Configurar as notificações).

Em caso de problema de comunicação com o site de e-commerce, a plataforma de pagamento envia um e-mail para o administrador da loja, destacando o motivo da falha (erro http. etc.) bem como os passos a seguir para enviar de novo a notificação no Back Office Estabelecimento Comercial.

Url de retorno para o site de e-commerce

O Estabelecimento Comercial pode configurar no Back Office Estabelecimento Comercial as URL de retorno "por padrão" no menu Configuração > Loja > aba Configuração :

Figura 1. Especificações dos URL de retorno

Pode configurar uma URL de retorno para a loja diferente segundo o modo.

O padrão é que o comprador seja redirecionado para a URL de retorno, seja qual for o resultado.

Se por acaso nenhuma URL estiver configurada neste nível, então o redirecionamento usará a URL principal da loja (campo URL definido no quadro Detalhes da loja).

O Estabelecimento Comercial tem a possibilidade de sobrescrever esta configuração no seu formulário de pagamento (ver capítulo Definir as URL de retorno).

Observação:

O status da regra "URL de notificação instantânea no final do pagamento" (IPN) está disponível nesta tela. Se esta última não estiver configurada, favor configurar-la (ver capítulo Configurar as notificações).