Ir para o conteúdo

Webhooks e reembolsos

URL do webhook

Os pagamentos são confirmados pela euPago ao chamar o pretix. Configure um URL no Backoffice da euPago (Canais → Listagem de Canais → "Receber notificação para um URL") para cada canal que usar, e escolha o webhook 2.0:

https://<o-seu-domínio-pretix>/eupago/webhook/

O URL exato aparece na página Configurações → euPago do evento. É global, não por evento, e aceita os dois formatos de webhook da euPago:

Formato Verificado com
v1.0 (GET) a chave API configurada
v2.0 (POST) a chave do webhook (assinatura, ou desencriptação se a encriptação estiver ativa)

Copie a chave do webhook do canal no Backoffice para a definição Chave do webhook. Sem ela, as notificações v2.0 de pagamento e de reembolso são recusadas. Caso contrário, qualquer pessoa que conheça o código do seu próprio pedido poderia marcá-lo como pago. Os cancelamentos e expirações continuam a ser aceites sem a chave, porque no pior caso falham um pagamento que o comprador pode repetir.

A opção "encriptar" do webhook no Backoffice também é suportada. O conteúdo é desencriptado com a mesma chave, e só é aceite para pagamentos do evento a que essa chave pertence.

Atenção

Sem um webhook a funcionar, os pagamentos nunca são confirmados e as encomendas ficam pendentes até expirarem.

Pagamentos feitos depois de um cancelamento

Se um comprador mudar de método de pagamento, o pretix cancela o pagamento Multibanco pendente. A referência em si continua a poder ser paga na euPago até expirar. Se o comprador a pagar na mesma, o pagamento é confirmado no pretix, para que o dinheiro nunca se perca de vista.

Se entretanto o pedido expirou e os bilhetes foram vendidos, o pretix não o consegue marcar como pago. O pagamento fica registado e o log do pretix mostra um erro quota is exceeded, para que possa resolver a situação com o comprador.

Cancelamentos, erros e expiração

Uma notificação v2.0 Cancel, Error ou Expired dá o pagamento pendente como falhado. Por exemplo, o comprador recusou o pedido MB WAY, o pedido falhou, ou uma referência Multibanco expirou. O comprador pode então pagar novamente na página do pedido. Uma notificação que chegue depois de o pagamento estar confirmado é ignorada.

Reembolsos

Os reembolsos não podem ser iniciados a partir do pretix. Faça-os no Backoffice da euPago. Quando a euPago envia a notificação Refund/Refunded, o plugin regista um reembolso externo no pagamento do pretix.

A notificação da euPago não inclui o valor do reembolso, por isso é sempre registado como reembolso total, e apenas uma vez por pagamento. Reenvios do webhook não reembolsam duas vezes. Uma notificação de reembolso que chegue antes da confirmação do próprio pagamento recebe um pedido para voltar a tentar, para que a euPago a reenvie mais tarde.

Se também usar o pt-invoicing, esse reembolso total emite automaticamente uma nota de crédito.