Inhoudsopgave

Instellen Mollie

Thijs Jan Hoving Bijgewerkt door Thijs Jan Hoving

Het is mogelijk een Mollie betaallink aan te maken en te versturen met verkoopfacturen. De betaling die volgt wordt eveneens geregistreerd in Newbase.

Je dient daarvoor zelf een overeenkomst met Mollie af te sluiten.

Dit is een handleiding met uitleg betreffende de instellingen die in Newbase gemaakt moeten worden om het werken met Mollie mogelijk te maken.

Er is ook een helpdocument over het werken met Mollie in Newbase.

1. Inrichten Newbase voor het gebruik van Mollie

Voor het gebruik van Mollie zijn er een aantal zaken die geregeld dienen te worden:

  • Het toekennen van widgets in verschillende modules
  • Het maken van de koppeling met Mollie
  • Het instellen van redirect URL's (dat is de webpagina waarop een klant na betaling terecht komt)
  • Het instellen van teksten voor gebruik in mails
  • Eventueel naar wens aanpassen van de tekst die de klant ziet tijdens het doen van de betaling

De interne applicatiebeheerder kan dit uitvoeren, of hierbij ondersteunen, want die heeft alle rechten om deze taken uit te voeren.

1.1 Het toekennen van widgets

1.1.1 Company

In de module company wordt de koppeling gelegd met Mollie en wordt een basis redirect URL ingevoerd. Ook kan hier voor zakelijke en particuliere debiteuren apart worden aangegeven of bij de aanmaak van een debiteurenkaart standaard dient te worden ingesteld dat de debiteur bij een factuur een Mollie betaallink meegestuurd krijgt.

De volgende widgets zijn nodig:

  • WID04950 - Mollie authenticatie
  • WID04854 - Mollie redirect
1.1.2 Debiteur

In de debiteur kan worden aangegeven of een debiteur standaard bij een factuur een Mollie betaallink meegestuurd krijgt. Dit kan per factuur nog wel worden aangepast.

  • WID04856 - Mollie betalingen
1.1.3 Verkoopfactuur

In de verkoopfactuur kan worden ingesteld of er een Mollie betaallink dient te worden meegestuurd en kan de betaallink worden ingezien.

Ook zijn hier meldingen te vinden over de betaling, bijvoorbeeld dat er betaald is.

  • WID04855 - Mollie instellingen
  • WID02099 - Externe integratie log

2. Het maken van de koppeling met Mollie

U dient zelf een abonnement bij Mollie af te sluiten

Er dient een koppeling te worden gelegd tussen de Newbase omgeving en de Mollie omgeving.

2.1 API key kopieren uit de Mollie omgeving

De koppeling tussen Newbase en Mollie maakt gebruikt van een unieke API key die in de Mollie omgeving aangemaakt kan worden en geregistreerd staat.

In het Mollie dashboard, de developer omgeving, kan de API key gekopieerd worden.

De stappen zijn:

  • Log in bij je Mollie Dashboard.
  • Ga naar Developers > API-keys.
  • Klik op Kopiëren.

Klik hier voor de Mollie help pagina

2.2 Koppeling maken in Newbase

2.2.1 Mollie API key invoeren

Ga naar de company waarvoor de koppeling met Mollie gemaakt wordt

Klik in wijzig stand in het widget 'Mollie instellingen' op de button 'Authenticeer Mollie'.

Plak hier de uit de Mollie omgeving gekopieerde API key, en klik op OK.

2.2.2 Overige Mollie instellingen

Koppel nu een gebruiker die de Mollie berichten die ontvangen worden betreffende betalingen behandelt. Deze gebruiker dient toegang te hebben tot de company en actief te zijn.

Het is mogelijk hier aan te geven dat voor nieuwe debiteuren die aangemaakt worden automatisch de indicatie voor een Mollie betaallink op de factuur wordt ingesteld. Dit is apart instelbaar voor zakelijke debiteuren en voor particulieren. Dit heeft geen gevolgen voor bestaande debiteuren.

2.3 Instellen van een Mollie redirect URL

2.3.1 Standaard Mollie redirect URL

Een redirect URL is een webpagina waarop de gebruiker terecht komt nadat de betaling is voldaan. Dat kan de homepage zijn, maar ook een speciale pagina bijvoorbeeld https://www.uwbedrijf.com/betaald.

Deze pagina is verplicht om in te vullen.

Dubbelklik in wijzigstand in het Mollie Redirect widget in de module Company, in het veld 'Redirect URL' (dit kan alleen indien er ook autorisatie bestaat).

Voer de url in.

LET OP: Voer een volledige URL in, dus met https:// in de URL

2.3.2 Speciale URL's

Het is mogelijk dat in specifieke situaties een andere redirect URL van toepassing is, bijvoorbeeld omdat het een deelbetaling of voorloopfactuur betreft, of dat het een bepaalde productgroep betreft

Newbase heeft hiermee rekening gehouden, en hiervoor een keuzelijst 'Maatwerk URL' gemaakt. Hierin kunnen specifieke URL's, ook meertalig, worden onderhouden, maar omdat de situaties zeer kunnen verschillen dient contact op te worden genomen met Newbase support, omdat er specifiek code dient te worden ingeschakeld of te worden ontwikkeld. Afhankelijk van de wens kan hiervoor een kostenopgaaf gedaan worden.

De Mollie link kan gebruikt worden in sjabloon teksten, maar ook in start- of eindteksten of betaalvoorwaarden, bijvoorbeeld in de betaalmethode.

De samenvoegcode hiervoor is: %%merge.fin_out_header.c_text_mollie%%

LET OP: deze code is niet in het keuzemenu voor samenvoegcodes te kiezen

3.1 Vertalingen

Deze samenvoegcode wordt in Newbase samengevoegd uit drie vertalingen, te beheren in de module 'Print label, start/eindtekst, velden'.

De combinatie van deze drie teksten (in de volgorde start,link,end) vormt samen de samenvoegcode %%merge.fin_out_header.c_text_mollie%%.

U kunt in deze tekst ook extra regeleindes opnemen om de tekst zowel in een situatie met als ook zonder Mollie betaallink te kunnen gebruiken.

Voor meer informatie over het aanpassen van 'Print label, start/eindtekst, velden' klik hier

3.2 Gebruik in een sjabloon voor bericht

In de module 'Sjabloon voor bericht / tekstblok' kan de samenvoegcode worden ingevoegd om te gebruiken in de bericht inhoud.

Een voorbeeld hiervan is:

Omdat de samenvoegcode alleen inhoud bevat als het een factuur met een Mollie betaallink betreft die verzonden wordt kan dit sjabloon ook gebruikt worden voor facturen die geen Mollie betaallink hebben.

Indien in de hierboven genoemde betalingen op de juiste wijze regeleindes zijn toegevoegd dan zal de inhoud zowel in de situatie met als zonder Mollie betaallink netjes opgebouwd worden.

Het kan dus zijn dat de regeleindes in het sjabloon verwijderd moeten worden, maar in de vertalingen voor de Mollie teksten moeten worden toegevoegd om tot het gewenste resultaat te leiden in zowel de situatie dat Mollie wel, of juist niet van toepassing is.

Het resultaat in de mail is in dit voorbeeld:

Voor meer informatie over de module de module 'Sjabloon voor bericht / tekstblok' klik hier.

3.3 Gebruik in een start- of eindtekst of betaalconditie

Om een klikbare Mollie betaallink toe te voegen in een PDF factuur zijn er verschillende mogelijkheden.

Start- en eindteksten voor verkoopfacturen zijn aan te passen in de module 'Print label, start/eindtekst, velden'. Hierin kan de samenvoegcode %%merge.fin_out_header.c_text_mollie%% worden opgenomen. Zie hiervoor ook de uitleg over de vertalingen.

Daarnaast kunnen voor specifieke situaties in de module 'Sjabloon voor bericht / tekstblok' sjabloon tekst blokken worden opgenomen. Zie de uitleg hiervoor over het gebruik in een sjabloon.

Ook kan in de voorwaarden de samenvoegcode tekst worden opgenomen.

Dit geeft op de PDF een klikbare betaallink weer:

Condities kunnen worden beheerd in de module 'Keuzelijsten'.

Voor meer informatie over keuzelijsten, klik hier.

4. De tekst die de klant ziet in het Mollie betaalscherm, aanpassen

4.1 De standaard tekst vanuit Newbase

In een Mollie betaalscherm staat standaard vanuit Newbase de volgende informatie:

  • Uw bedrijfsnaam (in het voorbeeld: 'Company A NL')
  • Uw bezoekplaats (in het voorbeeld: 'AMSTERDAM')
  • Het debiteurennummer (in het voorbeeld: 'DEA00081', om later de betaling correct te kunnen afletteren)
  • Het factuurnummer (in het voorbeeld: 'VFA2600212', om later de betaling correct te kunnen afletteren)
  • De factuurdatum (in het voorbeeld: '19-02-2026')
  • Uw referentie van de verkoopfactuur (in het voorbeeld: 'Telefonische order van 19-02-2026')

4.2 De tekst in het Mollie betaalscherm naar wens aanpassen

Het is mogelijk zelf de tekst die een klant in het Mollie betaalscherm ziet samen te stellen in de taal van de klant met samenvoegcodes.

In de module 'Print label, start/eindtekst, velden' bestaat daarvoor de sleutel: 'salesinvoice.mollie_payment_descr'.

Door te klikken op een regel, en vervolgens te wijzigen kunnen samenvoegcodes worden toegevoegd:

Een ingevuld scherm kan er dan als volgt uitzien:

Het betaalscherm in Mollie zal er dan als volgt uitzien:

Voor meer informatie over het aanpassen van 'Print label, start/eindtekst, velden' klik hier

Ben je hiermee geholpen?

Werken met Mollie in Newbase

Werken met openingstijden icm PCA / Marlin

Contact