Bestellingen doorgeven met de API en uitnodigingen versturen

POST https://api.trustsays.com/v1/orders met JSON in de body:

• orderRef: jullie ordernummer.
• email: het e-mailadres van de klant.
• name: de naam van de klant, optioneel.
• status: paid, delivered, cancelled of refunded.
• paidAt en deliveredAt: tijdstippen, optioneel.
• locale: de taal en het land van de klant, bijv. nl-NL. Dat bepaalt de taal van de uitnodiging.

Elke aanroep wordt verstuurd met drie headers:

• X-TrustSays-Key: de prefix uit de sleutel, dus de tekst tussen ts_ en de volgende underscore.
• X-TrustSays-Timestamp: de tijd in Unix-seconden.
• X-TrustSays-Signature: sha256= gevolgd door de HMAC-SHA256 in hex van het tijdstempel, een punt en de exacte body, met het geheim uit de sleutel.

Aanroepen die meer dan 5 minuten oud zijn, worden geweigerd.

order is created of updated. Hetzelfde ordernummer nogmaals werkt de bestelling bij. invitation vertelt wat er is gebeurd:

• scheduled: de uitnodiging is gepland.
• not_delivered: de bestelling is nog niet geleverd.
• not_in_plan: jullie abonnement heeft geen automatische uitnodigingen.
• quota: de uitnodigingen van deze maand zijn op.
• cancelled: geannuleerd of terugbetaald, dus er wordt geen uitnodiging verstuurd.
• duplicate, unsubscribed of invalid_email: de klant is al uitgenodigd, wil geen e-mails meer ontvangen, of het e-mailadres is ongeldig.

• Ongeldige handtekening: Onderteken de exacte body die jullie versturen, en controleer de sleutel.
• Het tijdstempel is te oud: Controleer de klok van de server.