Dankzij Twikey kan je op een slimme en geautomatiseerde manier betaalmethodes zoals domiciliëring en Bancontact aanbieden aan de klanten. Twikey zorgt voor een maximale conversie van uw klanten naar de betaalmethode domiciliëring, de automatisering van het domicilieringsproces met failure management en online betalingen zoals Bancontact en Payconiq.
Er zijn geen extra kosten die aangerekend worden door AdminPulse. Om de integratie op te zetten is er wel minimaal een Twikey Plus abonnement nodig aangezien AdminPulse achterliggend de API van Twikey zal aanspreken.
Inhoud
Overzicht mogelijke functionaliteiten bij koppeling met Twikey
Koppeling opzetten tussen AdminPulse en Twikey
QR-code en betaallink toevoegen aan factuursjabloon
Betaallink toevoegen aan e-mailsjabloon
Integratie in AdminPulse
1. Overzicht mogelijke functionaliteiten bij koppeling met Twikey
De integratie tussen AdminPulse en Twikey automatiseert deze zaken:
- het verkrijgen van een betaallink die gebruikt kan worden op de PDF van je factuur PDF en in de bijhorende e-mail, alsook een QR-code die op de PDF van de factuur kan gezet worden.
- facturen in AdminPulse markeren als betaald wanneer de betaling in Twikey geregistreerd wordt
- wanneer de klant kiest voor domiciliëring en het contract tekent:
- importeren van het contract in AdminPulse
- importeren van het bankrekeningnummer dat gebruikt wordt voor de domiciliëring in AdminPulse
- aanpassen van het relatieveld "Betaalmethode" naar domiciliëring in AdminPulse
2. Twikey-account
Voor de integratie met Twikey heb je een Twikey-account nodig. Dit account kan online worden aangevraagd via https://www.twikey.com
Let op: voor de integratie met AdminPulse heb je minstens een Plus abonnement nodig.
3. Koppeling opzetten tussen AdminPulse en Twikey
In AdminPulse
Wanneer je Twikey-account klaar is om te gebruiken, dien je de API gegevens in te geven op onze Admin-Connect webpagina.
Ga naar Algemene instellingen -> Geconnecteerde applicatie > Twikey: klik op "connect".
In het AdminPulse scherm dienen de volgende gegevens ingevuld:
- Klantnummer: Dit vind je in Twikey terug onder Instellingen -> Bedrijfsinformatie
- API-sleutel en privésleutel: Dit vind je in Twikey terug onder Instellingen -> API
In Twikey
In Twikey (Instellingen -> API) dienen deze gegevens ingevuld te worden:
- Callback URL: https://twikey.adminpulse.be/api/external/twikey/callback
- Zorg er voor dat de vinkjes voor documentupdates en betalingsupdates ingeschakeld zijn
In AdminPulse
Na het invullen van de gegevens kan je de connectie testen en opslaan. Indien de connectie niet gelukt zou zijn, kan je met de foutcode een support ticket aanmaken.
QR-code en betaallink toevoegen aan factuursjabloon
Er zijn twee nieuwe invulvelden die in het factuursjabloon kunnen gebruikt worden om de QR-code en betaallink op de factuur te krijgen.
Voor meer informatie en voor het makkelijk kopiëren en plakken hiervan vind je hier meer info.
Meer informatie over het aanpassen van je factuursjabloon kan je hier terugvinden.
-
{Image:PaymentQrCode}
-
{PaymentUrl}
Betaallink toevoegen aan emailsjabloon
Naast de PDF kan de betaallink ook toegevoegd worden aan het e-mailsjabloon. Het veld dat hiervoor gebruikt dient te worden is:
- {invoice.paymenturl}
Wanneer de klant dan op deze URL in de e-mail klikt, zal hij naar de betalingspagina van Twikey geleid worden.
Domiciliëringen
Twikey biedt jou als ondernemer de mogelijkheid om makkelijk domiciliëringen aan te bieden aan de klant. Meer hulp over het opzetten van de domiciliëringen zelf kan je verkrijgen bij je contactpersoon van Twikey.
Wanneer de koppeling met Twikey actief is en er een factuur vanuit AdminPulse met betaallink naar de klant wordt gestuurd, zijn er twee mogelijkheden:
De klant heeft nog geen domicilëring:
Wanneer de klant nog geen mandaat voor domiciliëring getekend heeft en op de betaallink klikt, krijgt hij de mogelijkheid om de factuur te betalen via één van de directe betalingsmogelijkheden, zoals bancontact.
Hij kan echter er ook voor kiezen om meteen een domiciliëring aan te gaan, via onderstaande knop. Op dat moment wordt de klant gevraagd om het mandaat te tekenen. Wanneer dit gebeurd is, zal het mandaat voor domiciliëring actief zijn en zal het factuurbedrag van deze factuur en ook alle toekomstige facturen automatisch geïnd worden via de bank.
Zodra het mandaat getekend is, zal AdminPulse het getekende contract in PDF-vorm toevoegen aan het documentoverzicht van deze klant. Bijkomend zal ook het bankrekeningnummer worden toegevoegd aan de relatiefiche en zal het veld "Betaalmethode" veranderen naar "Domiciliëring"
De klant heeft reeds een lopende domiciliëring
Wanneer de klant reeds een mandaat voor domiciliëring getekend heeft en deze ook actief is, zal hij bij het klikken op de betaallink geen betalingsmogelijkheden meer krijgen. Twikey toont onderstaande melding om aan te geven dat het bedrag automatisch geïnd zal worden.
Om deze reden raden we tevens aan om het factuursjabloon zodanig aan te passen dat de betalingsreferentie niet getoond wordt op de PDF van de factuur maar wel een melding om aan te duiden dat de betaling via domiciliëring zal verlopen.
Dit doet met door het factuursjabloon (Word-bestand) aan te passen met volgende velden (volledig kopiëren):
{IF RelationPaymentMethodDirectDebit} Betaling via domiciliëring {ENDIF RelationPaymentMethodDirectDebit}
{IF RelationPaymentMethodManual} Referentie bij betaling: {PaymentReference} {ENDIF RelationPaymentMethodManual}
In het e-mailsjabloon gebruikt men hiervoor deze velden:
{IF_relation.paymentmethod.direct}
Betaling via domiciliëring
{ENDIF_relation.paymentmethod.direct}
{IF_relation.paymentmethod.manual}
Referentie bij betaling: {invoice.paymentReference}
{ENDIF_relation.paymentmethod.manual}