Webhook di GoCardless: 498 Token Invalid, 204 e la firma Webhook-Signature

Cosa dice GoCardless

Qualsiasi altra risposta diversa da 2xx fa sì che GoCardless riprovi: 9 tentativi di consegna in totale, il primo più 8 nuovi tentativi, sempre più distanziati. Inoltre, attende la risposta al massimo 10 secondi.

Come si verifica la firma

GoCardless firma ogni invio con un HMAC SHA256 in esadecimale del corpo così com'è, con il segreto dell'endpoint, e lo invia nell'intestazione Webhook-Signature. Se il segreto che ha Odoo non è quello dell'endpoint, nessuna firma torna. Succede se si copia male il segreto, se lo si rigenera nella Dashboard senza aggiornarlo in Odoo, o se si inviano a un Odoo gli eventi di un altro account.

Il connettore non si ferma alla prima configurazione di GoCardless che trova: cerca quella che ha il segreto che firma quell'invio. Così una configurazione di test dimenticata non rifiuta gli eventi reali.

Cosa risponde Odoo con il connettore

La differenza di Odoo 20 non è una scelta del connettore: il suo server HTTP non permette di rispondere con un codice che non sia standard, e 498 non lo è. Ciò che succede dopo dipende da come arrivano gli eventi. In modalità avanzata vanno direttamente da GoCardless a Odoo: con 401, GoCardless riprova un invio che resterà non valido, e un segreto impostato male si vede come una serie di tentativi falliti nella Dashboard di GoCardless. Con la connessione in due clic arrivano tramite FlexigoTech Cloud, che considera quel 401 come definitivo, come un 498.

Se un evento non arriva

GoCardless garantisce che ogni evento arrivi almeno una volta, non esattamente una: può ripetersi. Il connettore registra ogni evento che applica, uno per evento e per configurazione di GoCardless, e se lo stesso evento arriva di nuovo non lo applica due volte. Questo conta con i soldi: un pagamento confermato due volte non deve registrare due incassi sulla fattura. E se un evento va perso, l'azione pianificata che ogni ora chiede a GoCardless gli eventi mancanti lo recupera, fino a 100 per passaggio.

Cosa fare

1. Se usi la connessione in due clic («Connect my GoCardless account»), i webhook li configura FlexigoTech Cloud: non c'è nessun segreto da copiare.
2. In modalità avanzata («Paste an access token (advanced)»), l'endpoint e il suo segreto li crei tu nella Dashboard di GoCardless: copia il segreto esatto nella configurazione di GoCardless in Odoo.
3. Se rigeneri il segreto, aggiornalo subito in Odoo; fino ad allora, ogni invio fallirà.
4. Controlla nella Dashboard di GoCardless gli invii falliti: da lì si possono rilanciare a mano.

Con il nostro connettore

In Odoo 17, 18, 19 e 20 il connettore verifica la firma di ogni invio rispetto al segreto di ogni configurazione di GoCardless, risponde con i codici che GoCardless comprende e, nel caso qualcosa vada perso, recupera gli eventi ogni ora.

Continua a leggere