Home > Documentatie > Integraties > Shopify > Extra opvolgacties > Order-Paid

Shopify events: order-paid

Het order-paid-event wordt, zoals de naam al aangeeft, getriggerd wanneer een bestelling uit een Shopify-integratie betaald is. Dit wordt middels een webhook doorgegeven aan Copernica, waardoor er, zodra een bestelling betaald is, opvolgacties uitgevoerd kunnen worden.

Variabelen

Bij Shopify-events zijn variabelen op twee manieren beschikbaar:

  • Webhook-data via {$trigger.webhook}: deze informatie komt rechtstreeks uit de webhook die Shopify naar Copernica stuurt.
  • API-data via {$trigger}: deze informatie wordt opgehaald via de Shopify GraphQL Admin API.

Wij adviseren om zoveel mogelijk gebruik te maken van de webhook-data. Hiermee voorkom je extra API-calls, bouw je e-mails sneller op en loop je minder snel tegen de rate limits van Shopify aan.

Webhook-data

Zodra Copernica een order-event ontvangt vanuit Shopify, zijn alle velden uit de Shopify-webhook beschikbaar via de {$trigger.webhook}-variabelen in opvolgacties en mailings, bijvoorbeeld {$trigger.webhook.id}.

Handige variabelen

De volgende velden zijn vaak handig om te gebruiken in opvolgacties en mailings:

  • {$trigger.webhook.total_price}: de totaalprijs van de bestelling
  • {$trigger.webhook.created_at}: het tijdstip waarop de bestelling geplaatst is
  • {$trigger.webhook.customer}: de klant die de bestelling geplaatst heeft
  • {$trigger.webhook.customer.first_name}: de voornaam van de klant die de bestelling geplaatst heeft
  • {$trigger.webhook.line_items}: een lijst van de producten in de bestelling
  • {$trigger.webhook.total_discounts}: de gegeven korting op een bestelling
  • {$trigger.webhook.shipping_address}: het adres waarop de bestelling bezorgd wordt

API-data

Alle velden die teruggegeven worden door de Shopify Admin API voor een order zijn beschikbaar via de 'trigger'-variabelen in opvolgacties en mailings, bijvoorbeeld: {$trigger.id}.

Handige variabelen

De volgende velden zijn vaak handig om te gebruiken in opvolgacties en mailings:

  • {$trigger.totalPriceSet.presentmentMoney}: de totaalprijs van de bestelling
  • {$trigger.createdAt}: het tijdstip waarop de bestelling geplaatst is
  • {$trigger.customer}: de klant die de bestelling geplaatst heeft
  • {$trigger.customer.firstName}: de voornaam van de klant die de bestelling geplaatst heeft
  • {$trigger.lineItems}: een lijst van de producten in de bestelling
  • {$trigger.totalDiscountsSet.presentmentMoney}: de gegeven korting op een bestelling
  • {$trigger.shippingAddress}: het verzendadres van de bestelling

Meer informatie over de beschikbar velden en het gebruik vind je in dit artikel.

Voorbeeld: bestelbevestiging

Met de volgende Smarty-code halen we de naam van de klant op en vermelden we welke producten er zijn besteld:

Beste {$trigger.attributes.customer.first_name},

Bedankt voor je bestelling van:
{foreach $trigger.webhook.line_items as $item}
  - {$item.name}: ({$item.quantity}x) voor {$item.price}
{/foreach}