Inhoudsopgave 1. Inleiding 2. In de backoffice 2.1 Configuratie 2.2 Een abonnement aanmaken 2.3 Een abonnement bewerken 2.4 Een abonnement verwijderen 2.5 Transacties bekijken 3. Via e-commerce 3.1 Input 3.2 Feedback 4. Via Batch Page 1 of 9-09/09/2017
1. Inleiding Met Subscription Manager kunt u periodieke betalingen op voorhand aanmaken en opslaan op basis van een datuminterval en een herhalingsfrequentie. Een typische toepassing is een abonnement op een tijdschrift, waarvoor de klant elke maand hetzelfde bedrag moet betalen tot hij zijn abonnement opzegt. De betaling van het abonnement kan op verschillende wijzen worden aangemaakt: Handmatig in uw Ingenico epayments-account Via de aanmaak van een transactie in e-commerce, DirectLink of Batch Page 2 of 9-09/09/2017
2. In de backoffice Wanneer u via Geavanceerd in uw accountmenu klikt op Abonnement, gaat u naar het dashboard 'Beheer van abonnementen', dat uit de volgende delen bestaat: Status abonnementen geeft een overzicht van uw huidige abonnementen. Wanneer u op het aantal abonnementen met een bepaalde status klikt, wordt de abonnementenlijst weergegeven. Via Algemene parameters kunt u de opties voor abonnementsbeheer configureren. Via Abonnementen bewerken / bekijken kunt u alle abonnementen die u in uw account hebt opgeslagen, doorzoeken, bekijken en bewerken. In plaats van ze in de browser te bekijken, kunt u de abonnementen ook in een tekstbestand downloaden. Via Abonnement aanmaken kunt u handmatig nieuwe abonnementen aanmaken. 2.1 Configuratie In het tabblad Algemene parameters kunt u de volgende instellingen vastleggen: Nieuwe pogingen. Het is mogelijk dat een van de betalingen een foutmelding retourneert. Ons systeem zal de betaling even vaak opnieuw proberen als hier is ingesteld (max. 5). De tijdspanne tussen elke poging is één dag. Als het maximum aantal nieuwe pogingen is bereikt Als u ervoor kiest om een abonnement te deactiveren, vinden er geen verdere betalingen voor plaats. Als u ervoor kiest om verder te gaan met de volgende betaling, zoals bepaald in het abonnement, dan zal die op de volgende betaaldatum worden uitgevoerd. In beide gevallen zal de mislukte betaling onvereffend blijven, nadat het maximale aantal pogingen werd bereikt. Wanneer een betaling na het maximale aantal pogingen is mislukt, wordt er een kennisgeving verzonden naar het e-mailadres dat in het tabblad Transactiee-mails op de pagina Technische instellingen van uw account is ingesteld. Afwijzing van aansprakelijkheid voor betaalpagina (alleen e-commerce) bepaalt of al dan niet een bericht wordt weergegeven waarin de toestemming van de koper gevraagd wordt met betrekking tot de bewaring van zijn betaalgegevens en de toekomstige abonnementsbetalingen. Als u de standaarddisclaimer van Ingenico epayments niet wenst te gebruiken, dan raden wij u ten stelligste aan om zelf de toestemming van de koper te vragen met betrekking tot de bewaring van zijn betaalgegevens en de toekomstige abonnementsbetalingen. 2.2 Een abonnement aanmaken Om een abonnement aan te maken, moet u de volgende informatie verstrekken: Veld Omschrijving ID van het abonnement Een uniek identificatienummer voor het abonnement. Dit is geen OrderID, omdat elke instantie van het abonnement een afzonderlijke betaling is. Naam/email/telefoonnummer Gegevens van de kaart- of rekeninghouder De betaalmethode en de overeenkomstige rekening- of kaartgegevens. Creditcard / Automatische incasso Opmerking: abonnementen met Duitse automatische incasso s kunnen niet worden aangemaakt met IBAN-rekeninginformatie; u moet daarentegen Konto/BLZ gebruiken. Nederlandse automatische incasso s worden niet ondersteund. Herhaling U kunt kiezen tussen dagelijks, wekelijks of maandelijks. Voor elke keuze kunt u de frequentie verfijnen (voor wekelijks kunt u de dag van de week kiezen; voor maandelijks kunt u de dag van de maand kiezen). Page 3 of 9-09/09/2017
Veld Omschrijving Als u een frequentie van enkele dagen wenst in te stellen, dan moet u Dagelijks kiezen en vervolgens het vereiste aantal dagen instellen. Dezelfde regel geldt voor weken en maanden. Als de betaling bijvoorbeeld elke twee maanden op de vijfde dag moet worden herhaald, stelt u Herhaling in op Maandelijks en Betaling vindt plaats op de 5 van elke 2 maand(en). Opmerking: - Wanneer de dag van de maand voor het abonnement groter is dan het aantal dagen in de huidige maand (30 februari bestaat bijvoorbeeld niet), wordt de laatste dag van de maand gebruikt. - Als u een abonnement aanmaakt met een startdatum in het verleden, wijzigen wij de Begindatum naar een datum in de toekomst op basis van een van de waarden die u hebt ingevoerd bij Herhaling (zie hiervoor). Abonnementsperiode. Begindatum / Einddatum Als de datum van de laatste betaling van het abonnement met de einddatum samenvalt, dan zal de betaling worden verwerkt. OrderID Bestelnummer dat bij elke abonnementsbetaling wordt vermeld. Door op de knop Toevoegen YYYY-MM-dd te drukken, voegt u de datum aan de OrderID toe, zodat u elke abonnementsbetaling gemakkelijk kunt onderscheiden. COM Beschrijving van de bestelling die bij elke abonnementsbetaling wordt opgenomen. Door op de knop Toevoegen YYYY-MM-dd te drukken, voegt u de datum aan het veld COM toe, zodat u elke abonnementsbetaling gemakkelijk kunt onderscheiden. Opmerkingen Vrij in te vullen tekstvak als u een opmerking voor de handelaar wilt opslaan. Status Wanneer u het abonnement op Geactiveerd instelt, zullen de betalingen in overeenstemming met de instellingen worden uitgevoerd. Wanneer u een abonnement aanmaakt, vindt er geen controle van de creditcard plaats. De geldigheid van de kaart wordt gecontroleerd bij de eerste abonnementsbetaling. 2.3 Een abonnement bewerken Het scherm voor de bewerking van een abonnement biedt dezelfde eigenschappen als het aanmaakscherm. Alle velden kunnen worden gewijzigd, behalve het veld ID van het abonnement. Als de kaart van de klant vervalt, kunnen de kaartgegevens worden bijgewerkt of gewijzigd. Het abonnement hoeft hiervoor niet opnieuw te worden aangemaakt. Merk op dat als u de betaaldatums voor een abonnement wijzigt, Ingenico epayments mogelijk een inhaalbetaling verwerkt voor alle transacties die anders overgeslagen worden als gevolg van de verandering. Bijvoorbeeld: Week 1 Abonnement aangemaakt voor verwerking elke woensdag. De eerste transactie wordt die woensdag verwerkt. Page 4 of 9-09/09/2017
Week 2 Abonnement bewerkt op dinsdag om de dag van verwerking te wijzigen in maandag Week 3 Abonnement verwerkt op maandag. 2.4 Een abonnement verwijderen Als u een abonnement wilt verwijderen, moet u dit abonnement opzoeken via de link Abonnementen bewerken / bekijken en vervolgens op de knop Verwijderen naast het betreffende abonnement klikken. Wanneer u een abonnement verwijdert, worden uitsluitend de geplande betalingen verwijderd. Lopende betalingen worden zo niet terugbetaald of geannuleerd. 2.5 Transacties bekijken Elke abonnementstransactie is een aparte betaling, met haar eigen PAYID/Betaal ID en status. U kunt die opzoeken via de link Beheer transacties in de backoffice. Als u alle abonnementstransacties wilt bekijken, dan is het eenvoudiger om deze via de Subscription Manager op te zoeken door de abonnements-id in te voeren (alleen de laatste 12 transacties zijn zichtbaar). Page 5 of 9-09/09/2017
3. Via e-commerce 3.1 Input Om een abonnement aan te maken via e-commerce of DirectLink, moet u een eerste transactie uitvoeren. Als bij e-commerce deze eerste transactie niet succesvol is, dan zal het abonnement niet worden aangemaakt. Tip: Als u bij de aanmaak van het abonnement geen echte transactie wil uitvoeren, kunt u een bedrag van 0 invoeren, dat dan alleen de kaart valideert. Om een abonnement aan te maken, moeten de volgende gegevens samen met de transactie worden verstuurd: Veld Omschrijving Formaat SUBSCRIPTION_ID Uniek identificatienummer van het abonnement. De abonnements-id moet dynamisch worden toegekend. AN, 50 SUB_AMOUNT Bedrag van het abonnement (kan verschillen van het bedrag van de oorspronkelijke transactie), vermenigvuldigd met 100, aangezien het formaat van het bedrag geen decimalen of andere scheidingstekens mag bevatten. N SUB_COM Beschrijving van de bestelling AN, 100 SUB_ORDERID OrderID voor abonnementsbetalingen AN, 40 d = dagelijks ww = wekelijks SUB_PERIOD_UNIT AN, 2 m = maandelijks SUB_PERIOD_NUMBER Tijdspanne tussen elke instantie van de abonnementsbetalingen. N SUB_PERIOD_MOMENT Afhankelijk van SUB_PERIOD_UNIT (niet van toepassing voor dagelijks (d), aangezien het tijdstip in dat geval identiek is aan de eenheid). Wekelijks (ww): 1 = zondag, 7 = zaterdag Maandelijks (m): dag van de maand (1-31) N SUB_STARTDATE Startdatum abonnement Datum SUB_ENDDATE Einddatum abonnement Datum SUB_STATUS 0 = inactief 1 = actief AN, 1 SUB_COMMENT Opmerking voor de handelaar AN, 200 CN Naam van de kaarthouder Moet verstuurd standaardveld op e-commerce-betaalpagina AN, 35 Page 6 of 9-09/09/2017
Denk eraan om deze velden in uw SHA-versleuteling op te nemen. Meer informatie over SHA vindt u bij e-commerce of DirectLink. De abonnementsbetalingen worden enkel uitgevoerd wanneer de abonnementsstatus actief is. De abonnementsstatus schakelt niet automatisch over naar 'actief' op de startdatum die voor het abonnement is ingesteld. Als de velden EMAIL (E-mail) en OWNERTELNO (Telefoonnummer eigenaar) bij de bestelling worden ingevuld, worden ze ook aan het abonnement toegevoegd. Opmerking: Abonnementsbetalingen worden altijd als direct sales verwerkt. Wanneer u echter e-commerce gebruikt, wordt de eerste transactie verwerkt zoals is geconfigureerd in de pagina Technische instellingen van uw account. 3.2 Feedback De volgende parameters worden teruggestuurd in de feedback na verkoop: Veld Omschrijving subscription_id Bevestiging van het unieke identificatienummer van het abonnement creation_status Geeft aan of het abonnement met succes aangemaakt werd. Mogelijke waarden: OK of ERROR. Belangrijk Voor de eerste transactie wordt de feedback teruggestuurd via de online post-sale server-to server feedback. Voor elke daaropvolgende transactie, wordt de feedback gestuurd met de offline post-sale feedback. Meer informatie hierover vindt u via Server-to-server feedback. Denk eraan om deze velden in uw SHA-OUT-versleuteling op te nemen. Meer informatie over SHA vindt u bij e-commerce of DirectLink. Page 7 of 9-09/09/2017
4. Via Batch De volgende velden moeten worden ingevuld voor batch-abonnementsbewerkingen: Veld (*=Vereist) Omschrijving Formaat 1 OPERATION* ADDSUBS (Abonnement toevoegen) DELSUBS (Abonnement verwijderen) AN, 8 2 CN* Naam van de kaarthouder AN, 35 3 ACC_CARDNO* Kaart- of bankrekeningnummer AN, 23 4 EXPDATE* Vervaldatum (indien van toepassing) AN, 4 5 BRAND* Merk van de betaalmethode AN, 25 6 PSPID* Identificatienummer van de handelaar in ons systeem AN, 30 7 SUBSCRIPTION_ID* Uniek identificatienummer van het abonnement AN, 50 8 AMOUNT* Bedrag van het abonnement, vermenigvuldigd met 100 (aangezien het formaat van het bedrag geen decimaaltekens of andere scheidingstekens mag bevatten). N 9 CURRENCY* Munteenheid (ISO-formaat met 3 tekens) AN, 3 10 PERIODICITY_UNIT* d = dagelijks ww = wekelijks m = maandelijks AN, 2 11 PERIODICITY_NUMBER* Tijdspanne tussen elke instantie van de abonnementsbetalingen. N 12 PERIODICITY_MOMENT* Afhankelijk van veld 10 Dagelijks (d): tijdspanne in dagen Wekelijks (ww): 1 = zondag, 7 = zaterdag Maandelijks (m): dag van de maand N 13 SUBSCRIPTION_STATUS* 0 inactief 1 actief N 14 START_DATE* Start- en einddatum. Het datumformaat moet jjjj-mm-dd zijn. Alle datums worden geconverteerd met de tijdzone van de gebruiker. Datum 15 END_DATE Bijvoorbeeld: als de START_DATE 2013/05/01 is en de gebruiker is ingesteld op GMT 1, wordt de datum/tijd geconverteerd naar 2013/05/01 1:00:00 (CET). Datum 16 EXTERNALREF_PATTERN Betalingsreferentie. U kunt datumformaten toevoegen die op de betalingsdatum door de eigenlijke waarden zullen worden vervangen. Bijvoorbeeld: abonnement 123 [MM-JJJJ] AN, 40 Page 8 of 9-09/09/2017
Veld (*=Vereist) Omschrijving Formaat 17 COMDESC_PATTERN Beschrijving van de bestelling. Ook hier kunt u datumformaten gebruiken, die op het moment van elke betaling door de eigenlijke waarden zullen worden vervangen. Bijvoorbeeld: Uw tijdschrift [JJJJddd] AN, 100 18 (leeg) 19 BUYER_EMAIL E-mailadres AN, 50 20 BUYER_TELNO Telefoonnummer AN, 50 21 COMMENT Tekstvak voor vrij in te vullen commentaar AN, 200 Het bestand moet een ASCII-tekstbestand zijn. Het bestand mag slechts één regel per abonnement bevatten. De regels worden gescheiden door het terugloopteken en regelopschuivingsteken (ASCII: 13 10 HEX: 0xD 0xA). De velden moeten worden gescheiden door een puntkomma ( ; ). De velden zelf mogen geen puntkomma ( ; ) bevatten. Voorbeeld van een VISA-abonnement: ADDSUBS;John Doe;4111111111111111;1012;VISA;PSPID;ID001;100;EUR;d;1;1;1;2010-08-13;2011-08-13;Cotisation [MM-YYYY];Paiement n [YYYYddd];;Bill.smith@yahooyahoo.com;0000000000;comment on this subs; Voorbeeld van een abonnement met automatische incasso: ADDSUBS;John Doe;XXXXXXXXXBLZXXXXXXXX;;DIRECT DEBITS DE;PSPID;ID002;100;EUR;d;1;1;1;2010-04-20;2010-05-15 00:00:00.000;Cotisation [MM-YYYY];Paiement n [YYYYddd];;Bill.smith@yahooyahoo.com;0000000000;comment on this subs; Opmerking: als u deze voorbeeldregels kopieert en plakt voor een test met uw testaccount, denk er dan aan om de PSPID en rekeningnummers te vervangen. Meer informatie vindt u in de documentatie over Batch. Page 9 of 9-09/09/2017