In questa pagina
Se non usate Shopify o WooCommerce, il vostro sistema può comunicare gli ordini a TrustSays. Quando un ordine è consegnato, il cliente viene invitato automaticamente. Gli inviti automatici richiedono Start o superiore. Gli ordini vengono salvati con tutti i piani.
Endpoint
POST https://api.trustsays.com/v1/orders con JSON nel body:
- orderRef: il vostro numero d’ordine.
- email: l’e-mail del cliente.
- name: il nome del cliente, facoltativo.
- status: paid, delivered, cancelled o refunded.
- paidAt e deliveredAt: orari, facoltativi.
- locale: lingua e paese del cliente, ad es. it-IT. Determina la lingua dell’invito.
Firma
Ogni chiamata viene inviata con tre header:
- X-TrustSays-Key: il prefisso della chiave, cioè il testo tra ts_ e il trattino basso successivo.
- X-TrustSays-Timestamp: l’ora in secondi Unix.
- X-TrustSays-Signature: sha256= seguito dall’HMAC-SHA256 in esadecimale del timestamp, un punto e il body esatto, con il segreto della chiave.
Le chiamate più vecchie di 5 minuti vengono rifiutate.
La risposta
order è created o updated. Lo stesso numero d’ordine inviato di nuovo aggiorna l’ordine. invitation indica cosa è successo:
- scheduled: l’invito è pianificato.
- not_delivered: l’ordine non è ancora consegnato.
- not_in_plan: il vostro piano non include inviti automatici.
- quota: gli inviti del mese sono esauriti.
- cancelled: annullato o rimborsato, quindi non viene inviato alcun invito.
- duplicate, unsubscribed o invalid_email: il cliente è già stato invitato, ha rifiutato le e-mail oppure l’e-mail non è valida.
Se non funziona
- Firma non valida: firmate il body esatto che inviate e controllate la chiave.
- Timestamp troppo vecchio: controllate l’orologio del server.
Tutti i clienti vanno invitati allo stesso modo. Comunicate tutti gli ordini, non solo quelli dei clienti contenti.
Ti è stato utile?
Hai ancora bisogno di aiuto?Scrivici e ti risponderemo. Rispondiamo nei giorni feriali dalle 8 alle 18.Contattaci