Wil je dat een klant direct na het accepteren van een offerte een betaallink ontvangt, bijvoorbeeld voor een aanbetaling of een verificatiebetaling voor een machtiging? Met een workflow maak je die link automatisch aan bij je betaalprovider en stuur je hem per e-mail naar de klant. De klant hoeft niets over te typen en de betaling komt rechtstreeks bij je betaalprovider binnen.
In dit artikel lees je hoe zo'n workflow is opgebouwd. We gebruiken een fictieve betaalprovider als voorbeeld. Hoe de aanroep er bij jouw betaalprovider precies uitziet, staat in de API-documentatie van die provider.
De workflow in één oogopslag
Trigger: Offerte geaccepteerd
Voorwaarde: Product is het product waarvoor je een betaling vraagt
↓
Actie: HTTP-verzoek
Maakt bij de betaalprovider een betaallink aan en krijgt die link terug in het antwoord
↓
Actie: Update sale
Slaat de betaallink op in het extra veld "Betaallink" van de sale (optioneel)
↓
Actie: Verstuur e-mail
Stuurt de klant een e-mail met de betaallink
Voordat je begint
- Je hebt een API-sleutel van je betaalprovider. Sla die op als secret, zodat hij niet zichtbaar in de workflow staat. Hoe dat werkt, lees je in Secrets: API-sleutels, tokens en wachtwoorden veilig opslaan in workflows.
- Wil je de link ook bij de sale terugzien? Maak dan een extra veld van het type tekst aan op de sale, bijvoorbeeld "Betaallink".
Stap 1: trigger en voorwaarde
Maak een nieuwe workflow aan en kies als trigger Offerte geaccepteerd. De workflow start dan zodra de klant de offerte accepteert. Wil je alleen een betaallink sturen bij een bepaald product, voeg dan een voorwaarde toe op Product. Meer over voorwaarden lees je in Workflow condities.
Stap 2: de betaallink aanmaken met een HTTP-verzoek
Voeg de actie HTTP-verzoek toe. Daarmee vraag je de betaalprovider een betaallink aan te maken. Hoe je methode, URL, kopteksten en inhoud instelt, staat in Workflow actie HTTP-verzoek. Voor ons fictieve voorbeeld ziet het er zo uit:
| Instelling | Voorbeeld |
|---|---|
| Methode | POST |
| URL | https://api.betaalprovider.example/v1/payment-links |
| Content-Type | application/json |
| Extra kopteksten | Authorization: Bearer {{secrets.BETAALPROVIDER}} |
| Inhoud | { "amount": "0.01", "currency": "EUR", "description": "Order {{sale.id}}", "email": "{{sale.email}}" } |
De betaalprovider stuurt een antwoord terug met daarin de betaallink. In ons voorbeeld ziet dat antwoord er zo uit:
{ "id": "pl_12345", "link": { "url": "https://pay.betaalprovider.example/pl_12345" } }
Stap 3: het antwoord gebruiken in de volgende acties
Het antwoord van het HTTP-verzoek kun je gebruiken in de acties die erna komen. Elk HTTP-verzoek heeft een eigen code, die je bij de actie ziet staan, bijvoorbeeld AB12CD34. Het antwoord vind je onder Variabelen bij de workflow-variabelen, en de variabele heeft deze vorm:
{{workflow.AB12CD34_http_response_body.link.url}}
Achter http_response_body volg je de opbouw van het antwoord, met een punt tussen elk niveau. In het voorbeeld staat de link onder link en daarbinnen onder url. Bij jouw betaalprovider kan dat anders heten. Kijk daarvoor in hun API-documentatie.
De link bij de sale opslaan (optioneel)
Voeg de actie Update sale toe en vul bij het extra veld "Betaallink" de variabele van stap 3 in. De link staat dan ook bij de sale, zodat je hem later kunt terugvinden of opnieuw kunt sturen.
De link naar de klant sturen
Voeg de actie Verstuur e-mail toe, met als ontvanger het e-mailadres van de klant. Zet de variabele van stap 3 in de tekst, bijvoorbeeld:
Bedankt voor je akkoord op de offerte. Rond je bestelling af via deze betaallink: {{workflow.AB12CD34_http_response_body.link.url}}
Liever een sms? Gebruik dan de actie Verstuur SMS met dezelfde variabele.
Tip: zet de workflow eerst op staging (app-staging.salesdock.nl) en gebruik daar de testsleutel van je betaalprovider. Zo controleer je of de link goed in de e-mail komt voordat je live gaat.
Let op: geeft de betaalprovider een foutmelding terug, dan stopt de workflow bij het HTTP-verzoek en wordt er geen e-mail verstuurd. Controleer in dat geval de logboeken van de workflow.