Zapier

Paytium Pro kan ook gekoppeld worden aan Zapier.com, en via Zapier aan meer dan 1500 andere apps. Zo kun je Paytium koppelen aan Slack, MoneyBird, Excel en noem maar op.

Waarom zie ik Paytium niet staan als ik op Zapier.com zoek?

Als je op Zapier.com zoekt tussen de apps dan zie je Paytium niet staan. Dat klopt. En toch is er een integratie tussen Paytium en Zapier.

De hoofdreden waarom Paytium niet tussen de apps staat is omdat Zapier zo hard is gegroeid dat ze strengere eisen zijn gaan stellen aan apps die getoond willen worden op Zapier.com. Ze konden de enorme hoeveelheid nieuwe apps namelijk niet bijbenen (die moeten allemaal met grote zorg aan de website toegevoerd worden natuurlijk, en ze willen dan ook graag een nieuwsbrief sturen aan hun gebruikers etc).

Een eis bijvoorbeeld is dat bij voorbaat al tientallen gebruikers van die app gebruik moeten maken. En omdat de integratie tussen Zapier en Paytium nog zo nieuw is (minder dan zes maandjes jong), zijn er nog geen tientallen gebruikers (het gaat wel de goede kant op). Daarom kun je Paytium en Zapier wel met elkaar koppelen, maar zie je Paytium niet op Zapier.com tussen de apps staan.

Zorgvuldig omgaan met tags en formulier informatie

Tags kunnen gebruikt worden voor het tonen van informatie uit Paytium formulier-velden in emails (Paytium > Emails) en facturen (Paytium > Instellingen > Facturen). Een tag ziet er bijvoorbeeld zo uit: {pt-field-text-1}. Tags worden nu dynamisch per formulier aangemaakt, dat betekent het volgende.

• Als je de volgorde van velden aanpast in je formulier, is de tag misschien aangepast en zal die tag niet meer de gewenste informatie in een email of factuur tonen. Als je velden verwijdert of toevoegt, of de volgorde van velden aanpast, moet je dus je emails en factuur template nakijken en wellicht ook aanpassen.
• Als je meerdere formulieren hebt, dan kan een tag in een email of factuur voor een bepaald formulier geen of andere informatie tonen als de email of factuur gebruikt wordt voor een ander formulier.

De oplossing voor emails, is om specifieke emails per formulier te gebruiken. De oplossing voor facturen, is om in ieder formulier de NAW gegevens die je nodig hebt voor de facturen, bovenaan het formulier te zetten en om maar één formulier per pagina in WordPress te hebben.

Dit is niet echt logisch of gebruiksvriendelijk, en dat vinden wij heel jammer. Om dit op te lossen zijn wij bezig met een form builder. Dit is grafische formulier bouwer voor Paytium, zodat je straks formulieren kan bouwen zonder shortcodes. Dan zijn dit soort foutjes en problemen verleden tijd!

Hoe koppel ik Paytium en Zapier aan elkaar?

Paytium maakt voor de Zapier integratie gebruik van de zogenaamde “webhook”. Daarvoor moet je eenmalig die webhook aanvragen bij Zapier, en die knippen/plakken naar Paytium. Doe dat volgens het onderstaande stappenplan, en dan lukt het je vast.

Let op: voordat je begint moet je al een Paytium formulier op je website hebben staan, want die heb je straks nodig om te testen. Het mag ook een tijdelijk en nep formulier zijn, en Paytium mag in de test modus staan.

Let op: als je de Zapier integratie gaat gebruiken, laat ons dit alsjeblieft weten! Wij moeten bijhouden hoeveel mensen de integratie gebruiken zodat Paytium ook vindbaar wordt als je op Zapier.com zoekt naar apps.

Nieuwe zapp aanmaken

• Login op Zapier.com
• Maak een nieuwe Zap aan door bijvoorbeeld rechtsboven op de oranje knop “Make a Zap!” te klikken
• Je komt nu in een speciaal overzicht waar je een Zapp kunt maken, als het goed is ben je bij de eerste stap “Trigger”
• Bij “Choose a Trigger App”, zoek je en selecteer je “Webhooks” en klik op “Save + Continue”.
• Selecteer nu “Catch Hook” en klik op “Save + Continue”.
• De volgende optie “Pick off a Child Key” mag je leeg laten, klik op “Continue”.
• Je bent nu bij stap “Test Webhooks by Zapier” en daar staat je webhook URL.
• Kopieer de webhook URL. Laat deze pagina openstaan (je komt straks terug)!

Zapier webhook in Paytium instellen

• Open een nieuw tabblad in je browser en login op jouw website (waar Paytium geïnstalleerd staat)

• Ga naar Paytium > Instellingen > Zapier en plak de webhook URL bij Paytium.
• Vink “Enable integration” aan in Paytium.
• Klik daarna op “Wijzigingen opslaan”.

Je kunt ervoor kiezen om niet bij alle betalingen de webhook van Zapier aan te roepen, maar bijvoorbeeld alleen bij betalingen die status “Betaald” krijgen. Als je dat doet, scheelt het weer een stap in je “zapp”.

Sinds versie 4.3.6 is het nu ook mogelijk om naast de webhook van Zapier, een 2de webhook te plaatsen/gebruiken zonder daarbij de webhook URL van het betaalformulier te overschrijven.
Gebruik hiervoor de volgende shortcode met een webhook-URL die op een bepaald formulier kan worden toegepast.

[paytium_zapier webhook_url="https://hooks.zapier.com/hooks/catch/9385551/bg4zvn0" status="paid, failed" /]

“webhook_url” : is je zapier webhook url
“status”: is de ‘comma separated list of statuses’ om de Zapier webhook te triggeren.
Wanneer een van deze leeg is, worden globale waarden van de pagina instelling gebruikt.

Webhook testen bij Zapier

• Ga terug naar de openstaande pagina bij Zapier en klik op “Ok, I did this”.
• Zapier gaat nu “luisteren” of er echt informatie binnenkomt op die webhook. Daarvoor moet jij nu een nep betaling plaatsen met het Paytium formulier dat op jou website staat.
• Als de betaling is ontvangen zie je bij Zapier staan “Test Successful!”. Klik op “Continue”.

De echte zap maken

Nu ga je eindelijk naar het leukste deel “Action”, het koppelen van acties aan de informatie uit Paytium.

Het gaat je enorm helpen als je nu op de website van Zapier de integratie zoekt die je wilt maken met Paytium. Zoek bijvoorbeeld in die lijst naar “Contant Contact” of “MoneyBird” en lees die pagina door.

Het correct doorlopen en instellen van Zapier is soms wat uitdagend. Besteed er rustig wat tijd aan, en neem vooral contact met Zapier support op als het niet direct lukt. Ze hebben erg goede ondersteuning en staan echt te springen om je te helpen!

Stel 1:
Je wilt na een succesvolle betaling de payment_id gebruiken als een couponcode in bijvoorbeeld Eventbrite ( de coupon wordt dus met EventBrite gemaakt) voor bevoordeeld een gratis toegang voor 1 jaar tot alle beschikbare evenementen.
Je wilt weten of dit mogelijk is via Paytium die Zapier activeert zodat Zapier de payment_id ontvangt in een API Post naar Eventbrite inclusief een vermelding in de een andere omgeving in Zapier.

Oplossing:
Paytium stuurt betalingsgegevens naar Zapier. Als dit niet lukt of fout gaat mail gerust naar support@paytium.nl.
Hoe het van Zapier naar de bijvoorbeeld EventBrite API moet gaan zal ongetwijfeld mogelijk zijn.
Het is dus sterk aangeraden om in dit geval vooral contact op te nemen met Zapier support . Ze hebben ook hier voor uitstekende ondersteuning en staan echt te springen om je te helpen!
Je kunt natuurlijk ook ervoor kiezen om tijd te besparen, door gebruik te maken van de functionaliteit Paytium Plus en Pro Discount Codes https://www.paytium.nl/handleiding/discounts-code/

Stel 2:
Geen succesvolle koppeling in Zaps:
Op het moment dat er een ‘open’ betaling omgezet wordt in ‘betaald’ wordt de ‘_pt-klant-e-mail’ niet verzonden.
Bij een directe betaling werkt het prima , de info wordt dan via Paytium correct naar de webhook gestuurd: ‘_pt-customer-email’).
MAAR wanneer een [paytium_no_payment /] in het formulier gebruikt wordt, wordt de ‘ _pt-customer-email’ (en meer) NIET via Paytium naar Zapier verzonden.

Oplossing:
Wanneer zowel de ‘_pt-customer-email’ & ‘_pt-customer-name’ ontbreekt in de verzend data wordt er geen succesvolle koppeling gemaakt in Zaps.
Dit komt omdat “_pt-customer-” e-mailvelden alleen worden aangemaakt als het een daadwerkelijke om een betaling “payment” gaat, dus niet bij het indienen van een formulier “submission” ( [paytium_no_payment /] )
Configureer de Zap om velden te gebruiken die in beide gevallen verzonden moeten worden (bv “_pt-field-email-..” ) om zowel de betalingen “payments” als het indienen van gegevens “submission” , data te verzenden.

Stel 3:
Stel je hebt een koppeling gemaakt met Zapier naar Moneybird.
Nu wordt er bij terugkerende betaling bij gebruik van volgende Paytium code:
[ paytium_field = “label” label= “Maandelijkse betaling van €14,95” amount =“14,95” tax=“21” /]
een factuur dubbel ontvangen.

Oplossing:
Je kunt ervoor kiezen om tijd te besparen, door gebruik te maken van de functionaliteit Paytium Facturen https://www.paytium.nl/handleiding/facturen/
Of je kan in Zapier enkele instellingen veranderen zodat de terugkerende betaling in de MoneyBird integratie niet ge-triggerd wordt om vervolgens wederom een faktuur aan te maken.
Paytium creëert namelijk niet twee keer een faktuur.