Inhoudsopgave 1. Inleiding 2. Integratie met e-commerce 2.1 Standaard Ingenico epayments-velden 2.2 Facturatie- en leveringsgegevens 2.3 Bestelgegevens 2.4 Voorbieeld 3. Feedback over de transactie 3.1 Bestelgegevens 3.2 Fouten 4. Terugbetalingen 5. Onderhoud 5.1 DirectLink 5.1.1 Gegevens 5.1.2 Voorbeeld 5.2 Batch 5.2.1 Gegevens 5.2.2 Voorbeeld Page 1 of 14-09/09/2017
1. Inleiding Dit document geeft informatie over de integratie (met e-commerce) en het gebruik van de AfterPay-betaalmethode. Page 2 of 14-09/09/2017
2. Integratie met e-commerce U dient bij elke bestelling een aantal bijkomende parameters te verzenden. Dit is alleen mogelijk met een POST-aanvraag. 2.1 Standaard Ingenico epayments-velden De volgende parameters kunnen of moeten voor elke transactie worden ingediend: Veld Beschrijving Formaat Verplicht AMOUT Totaal bedrag van de bestelling (inclusief btw), vermenigvuldigd met 100 (om problemen met decimalen te vermijden), dus 1,00 x 100 --> 100 CURREC Alpha-ISO-code van de munteenheid (EUR, GBP, CHF, enz.) A, 3 LAGUAGE Gelokaliseerde taal van de klant (nl_l, nl_be, fr_fr, enz.) Indien niet ingediend, wordt de standaardtaal Engels gebruikt. A, 5 OPERATIO Definieert het soort aanvraag, waarbij de standaardbewerkingscode wordt genegeerd Values: RES / SAL ORDERID De unieke referentie van uw bestelling A, 40 PSPID Uw unieke identificatie in het systeem A, 30 2.2 Facturatie- en leveringsgegevens De volgende parameters kunnen of moeten met elke bestelling voor AfterPay worden ingediend: Veld Beschrijving Formaat Verplicht CIVILIT Titel (M/V) factuur A, 10 ECOM_BILLTO_POSTAL_AME_FIRST Voornaam factuur A, 35 ECOM_BILLTO_POSTAL_AME_LAST Achternaam factuur A, 35 OWERADDRESS Straatnaam factuur A, 35 ECOM_BILLTO_POSTAL_STREET_UMBER Huisnummer factuur A, 10 OWERZIP Postcode factuur A, 10 OWERTOW Stad factuur A, 25 OWERCT Landcode (BE, FR, L, DE, enz.) factuur A, 2 EMAIL E-mailadres factuur A, 50 Page 3 of 14-09/09/2017
Veld Beschrijving Formaat Verplicht A, 30 OWERTELO Telefoonnummer factuur (AfterPay accepts max. 10) ECOM_SHIPTO_POSTAL_AME_PREFIX Aanspreking (Mr., Mevr., enz.) levering A, 10 ECOM_SHIPTO_POSTAL_AME_FIRST Voornaam levering A, 35 ECOM_SHIPTO_POSTAL_AME_LAST Achternaam levering A, 35 ECOM_SHIPTO_POSTAL_STREET_LIE1 Adres levering A, 35 ECOM_SHIPTO_POSTAL_STREET_UMBER Huisnummer levering A, 10 ECOM_SHIPTO_POSTAL_POSTALCODE Postcode levering A, 10 ECOM_SHIPTO_POSTAL_CIT Stad levering A, 25 ECOM_SHIPTO_POSTAL_COUTRCODE Landcode (BE, FR, L, DE, enz.) levering A, 2 ECOM_SHIPTO_OLIE_EMAIL E-mailadres levering A, 50 ECOM_SHIPTO_DOB Geboortedatum klant levering dd/mm/yyyy DATEI Datum en tijd levering mm/dd/yyyy hh:mm:ss ORDERSHIPMETH Leveringsmethode A, 25 ORDERSHIPCOST Leveringskost, exclusief btw Bedrag vermenigvuldigd met 100, 10 ORDERSHIPTAX Bedrag belasting levering Bedrag vermenigvuldigd met 100 ORDERSHIPTAXCODE Belastingscode (bijv. 19%) levering, 10 Extra parameters voor B2B REF_CUSTOMERREF ummer Kamer van Koophandel (KVK) A, 20 ECOM_SHIPTO_COMPA Leveringsbedrijf A, 50 ECOM_SHIPTO_TVA Btw-nummer A, 20 REF_CUSTOMERID Klantennummer A, 17 COSTCETER Afdeling van het bedrijf A, 20 Page 4 of 14-09/09/2017
2.3 Bestelgegevens De volgende parameters kunnen of moeten met elke bestelling voor AfterPay worden ingediend: Veld Beschrijving Formaat Verplicht ITEMIDx Identificatie van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMID1, ITEMID2 enz.) A, 15 ITEMAMEx aam van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMAME1, ITEMAME2 enz.) A, 40 ITEMPRICEx Prijs van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMPRICE1, ITEMPRICE2 enz.), 15 ITEMQUATx Aantal items (vervang "x" door een getal om meerdere items te verzenden: ITEMQUAT1, ITEMQUAT2 enz.), 15 ITEMCATEGORx Aantal items (vervang "x" door een getal om meerdere items te verzenden: ITEMQUAT1, ITEMQUAT2 enz.) A, 50 ITEMVATCODEx Btw-code van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMVATCODE1, ITEMVATCODE2 enz.) percentage TAXICLUDEDX Als "1" wordt verzonden als waarde voor deze parameter, wordt de ITEMPRICEX inclusief btw beschouwd en berekent ons systeem de btw voor het item niet. Deze functie wordt aanbevolen, want hierdoor worden problemen vermeden bij het afronden van de regeltotalen van de bestelling. (vervang X door een getal om meerdere items te verzenden: TAXICLUDED1, TAXICLUDED2 enz.) : 1 Opmerking: Het totale bedrag moet worden vermenigvuldigd met 100 om verwarring rond het decimaalteken te vermijden. Deze techniek wordt echter IET geïmplementeerd op detailniveau, waar het decimaalteken moet inbegrepen zijn en altijd een punt "." moet zijn. Op die manier kan de handelaar indien gewenst bedragen met meer dan 2 decimalen indienen. Oplopende volgorde van regelitemdetails voor SHA-berekening Houd er rekening mee dat vanaf 10 regelitemdetails de volgorde van de parameters voor de SHA-berekening kan afwijken van wat er door uw systeem wordt verwacht. Hoewel we voor de berekening van de SHA er normaal op aandringen dat alle parameters alfabetisch gesorteerd zijn, wordt voor de regelitemdetails een "logisch" oplopende volgorde gehanteerd: - Oplopende volgorde: 1, 2, 3, 4, 5, 6, 7, enz. - Alfabetische volgorde: 1, 10, 11, 2, 3, 4, enz. (IET toegepast) 2.4 Voorbieeld Het volgende formulier simuleert een AfterPay-transactie met alle vereiste velden. Page 5 of 14-09/09/2017
Vergeet niet de PSPID-waarde te vervangen door uw eigen waarde en uw SHA-handtekening dienovereenkomstig te berekenen. <form id="form1" method="post" action="https://ogone.test.v-psp.com/ncol/test/orderstandard.asp"> <!-- standard Ingenico epayments fields --> <input type="text" name="orderid" value ="order123"/><br/> <input type="text" name="amout" value ="1309"/><br/> <input type="text" name="laguage" value="nl_l"/><br/> <input type="text" name="pspid" value="[yourpspid]"/><br/> <input type="text" name="currec" value="eur"/><br/> <!-- Invoicing Information --> <input type="text" name="civilit" value ="M"/><br/> <input type="text" name="ecom_billto_postal_ame_first" value ="John"/><br/> <input type="text" name="ecom_billto_postal_ame_last" value ="Doe"/><br/><br/> <input type="text" name="oweraddress" value ="test street"/><br/> <input type="text" name="ecom_billto_postal_street_umber" value ="66"/><br/> <input type="text" name="owerzip" value ="3000 AA"/><br/> <input type="text" name="owertow" value ="Rotterdam"/><br/> <input type="text" name="owerct" value ="L"/><br/> <input type="text" name="owertelo" value ="0302333459"/><br/> <input type="text" name="email" value ="john@doe.com"/><br/> <!-- Delivery Information --> <input type="text" name="ecom_shipto_dob" value ="08/10/1940"/><br/> <input type="text" name="ecom_shipto_postal_ame_first" value ="John"/><br/> <input type="text" name="ecom_shipto_postal_ame_last" value ="Doe"/><br/><br/> <input type="text" name="ecom_shipto_postal_street_lie1" value ="postal street"/><br/> <input type="text" name="ecom_shipto_postal_street_umber" value ="66"/><br/> <input type="text" name="ecom_shipto_postal_postalcode" value ="3000 AA"/><br/> <input type="text" name="ecom_shipto_postal_cit" value ="Rotterdam"/><br/> <input type="text" name="ecom_shipto_postal_coutrcode" value ="L"/><br/> <input type="text" name="ecom_shipto_olie_email" value ="john@doe.com"/><br/> <!-- order details, item 1 --> <input type="text" name="itemid1" value ="1"/><br/> <input type="text" name="itemame1" value ="first item"/><br/> <input type="text" name="itemprice1" value ="11.90"/><br/> <input type="text" name="itemquat1" value ="1"/><br/> <input type="text" name="itemvatcode1" value ="19%"/><br/> <input type="text" name="taxicluded1" value ="1"/><br/> <!-- order details, item 2 --> <input type="text" name="itemid2" value ="2"/><br/> <input type="text" name="itemame2" value ="Shipping costs"/><br/> <input type="text" name="itemprice2" value ="1.00"/><br/> <input type="text" name="itemquat2" value ="1"/><br/> <input type="text" name="itemvatcode2" value ="19%"/><br/> <input type="text" name="taxicluded2" value ="0"/><br/> <!-- B2B parameters (if applicable) --> <input type="text" name="ref_customerref" value ="12345"/><br/> Page 6 of 14-09/09/2017
<input type="text" name="ecom_shipto_compa" value ="MyCompany"/><br/> <input type="text" name="ecom_shipto_tva" value ="123456789"/><br/> <input type="text" name="ref_customerid" value ="0123456789"/><br/> <input type="text" name="costceter" value = "Finance"/><br/> <!-- don't forget your SHA-I signature! --> SHASIG<input type="text" name="shasig" value="[your SHA-I signature]"/><br/> <input type="submit" value="submit"/> </form> Page 7 of 14-09/09/2017
3. Feedback over de transactie 3.1 Bestelgegevens Alle bestelgegevens kunnen worden bekeken in uw Ingenico epayments-account, via het menu Operations, met behulp van de koppeling "View transactions". Onderaan de details van de bestelling ziet u de items en de btw: 3.2 Fouten In geval van een fout wordt een specifieke foutcode (parameter CERROR) getoond. De handelaar kan deze input desgewenst gebruiken om de koper betere feedback te geven voor de correctie of aanvulling van zijn input. De volgende tabel bevat een niet-limitatieve lijst van mogelijke fouten: Foutcode Beschrijving 50001220 Ongeldig telefoonnummer van de klant 50001221 Ongeldig formaat van postcode 50001222 Voornaam / achternaam ontbreekt 50001223 Ongeldig formaat van voornaam / achternaam 50001224 Telefoonnummer van de klant ontbreekt 50001225 Ongeldig formaat van voornaam / achternaam Page 8 of 14-09/09/2017
4. Terugbetalingen Om terugbetalingen te kunnen uitvoeren, dient u ervoor te zorgen dat de optie "Terugbetalingen" beschikbaar is op uw account. In geval van twijfel kunt u contact opnemen met ons ons Sales team. Wanneer u een transactie bekijkt, klikt u op de knop "Geavanceerd" onderaan het scherm, waardoor de mogelijkheden voor terugbetaling verschijnen. Als u op "Terugbetaling" klikt, toont ons systeem een detailscherm waarin u de terug te betalen items kunt opgeven. Standaard bevat de kolom Aantal de bestelhoeveelheden; dit betekent dat, als u de waarden niet wijzigt, de volledige bestelling wordt terugbetaald. Om een transactie gedeeltelijk terug te betalen, past u de hoeveelheden aan (of gebruikt u voor elk item de knop "Verwijderen") om te voorkomen dat bepaalde artikelen worden terugbetaald. Merk op dat de kolom "Btw incl." aangeeft of het bedrag al dan niet de btw omvat. Klik op "Indienen" om de terugbetaling te bevestigen. Page 9 of 14-09/09/2017
5. Onderhoud 5.1 DirectLink Onderhoudsactiviteiten (terugbetalingen en registraties) kunnen via DirectLink worden uitgevoerd. Opmerking: U dient de optie Ingenico epayments DirectLink te activeren in uw Ogone-account om deze functie te gebruiken. eem contact op met ons Salesteam voor meer informatie over dit product. 5.1.1 Gegevens De volgende velden kunnen of moeten worden ingediend bij elke aanvraag voor onderhoud: Veld Beschrijving Formaat Verplicht AMOUT Totaal terug te betalen bedrag, inclusief btw. CURREC Valuta van transactie (EUR, CHF, USD, GBP, enz.) A, 3 Uit te voeren handeling. OPERATIO RFD = gedeeltelijke terugbetaling RFS = (laatste) gedeeltelijke of volledige terugbetaling A, 3 Voor een volledige lijst van de mogelijke bewerkingen raadpleegt u het Parameter Cookbook in uw Ingenico epayments-account. ORDERID De unieke referentie van uw bestelling A, 30 PAID Onze betaalreferentie, die na de initiële transactie naar u werd gestuurd PSPID Uw unieke identificatie in het systeem A, 30 PSWD Het wachtwoord van de gebruiker A, 20 De gebruiker die het onderhoud uitvoert. Dit is om beveiligingsredenen vereist. De USERID gebruiker moet API-privileges hebben (raadpleeg de the User Manager - documentatie voor meer informatie) A, 20 Veld Beschrijving Formaat Verplicht ITEMIDX Identificatie van het item (vervang X door een getal om meerdere items te verzenden: ITEMID1, ITEMID2 enz.) A, 15 ITEMAMEX aam van het item (vervang X door een getal om meerdere items te verzenden: ITEMAME1, ITEMAME2 enz.) A, 30 Page 10 of 14-09/09/2017
Veld Beschrijving Formaat Verplicht Prijs van het item (vervang X door een getal om meerdere items te verzenden: ITEMPRICEX ITEMPRICE1, ITEMPRICE2, enz.)vermenigvuldigd met 100 (in tegenstelling tot de originele indiening) ITEMQUATX Aantal items (vervang X door een getal om meerdere items te verzenden: ITEMQUAT1, ITEMQUAT2 enz.) ITEMVATCODEX Btw-code van het item (vervang X door een getal om meerdere items te verzenden: ITEMVATCODE1, ITEMVATCODE2 enz.) Percentage Als dit veld gelijk is aan 1, wordt ervan uitgegaan dat de ITEMPRICEX inclusief btw is, en berekent ons systeem de btw voor het item niet. Als dit veld gelijk is aan 0 (of blanco blijft of niet wordt verzonden), berekent ons systeem de btw voor het item op basis van de ITEMVATCODEX TAXICLUDEDX Deze functie is bedoeld om problemen te vermijden met het afronden van de regeltotalen van de bestelling.(vervang X door een getal om meerdere items te verzenden: TAXICLUDED1, TAXICLUDED2 enz.) 0 or 1 (vervang X door een getal om meerdere items te verzenden: TAXICLUDED1, TAXICLUDED2 enz.) 5.1.2 Voorbeeld <form action="https://ogone.test.v-psp.com/ncol/test/maintenancedirect.asp" method="post"> <input type="text" name="pspid" value="[your pspid]"/><br/> <input type="text" name="userid" value="[username]"/><br/> <input type="text" name="pswd" value="[password]"/><br/> <input type="text" name="paid" value="[payid] "/><br/> <input type="text" name="orderid" value="[order id]"/><br/> <input type="text" name="amout" value="119"/><br/> <input type="text" name="operatio" value="rfd"/><br/> <input type="text" name="currec" value="eur"/><br/> <input type="text" name="itemid1" value="1"/><br/> <input type="text" name="itemame1" value="first item"/><br/> <input type="text" name="itemprice1" value="119"/><br/> <input type="text" name="itemquat1" value="1"/><br/> <input type="text" name="itemvatcode1" value="19%"/><br/> <input type="text" name="taxicluded1" value="1"/><br/> <input type="submit" name="submit" value="submit"/> </form> Opmerking: De SHA-handtekening is niet vereist voor onderhoudsactiviteiten. Een testpagina voor DirectLink is hier beschikbaar: https://ogone.test.v-psp.com/ncol/test/testdm.asp?details=1 Page 11 of 14-09/09/2017
OHL;[your pspid];[your password];;[your username]; OHF;[file name];mtr;rfd;1; MTR;EUR;;;;;;;[PAID];RFD;;;;[your pspid];;1;;;;;;;;;;;;;;;;;;119; DET;1;2;first item;119;1;19%;;;;;;;; OTF; Gedeeltelijk onderhoud: Merk op dat het voorbeeld op dezelfde manier van toepassing is voor gedeeltelijke/meervoudige onderhoudsactiviteiten. Dit betekent dat ook de regelitemdetails verplicht zijn in bijvoorbeeld aanvragen voor gedeeltelijke terugbetaling. Ga voor meer informatie naar DirectLink. 5.2 Batch Onderhoudsactiviteiten (terugbetalingen, registraties) kunnen via Batch worden uitgevoerd. Opmerking: U dient de optie Ingenico epayments Batch te activeren in de Ingenico epayments-account om deze functie te gebruiken. eem contact op met ons ons Sales team voor meer informatie over dit product. 5.2.1 Gegevens De volgende informatie moet samen met elk batchbestand worden verzonden: Aanmeldinformatie: OHL Positie Veld Formaat 1 Vaste waarde: 'OHL'. Dit geeft aan dat de regel aanmeldinformatie bevat / 2 PSPID, de unieke identificatie van de handelaar op ons platform 3 Het wachtwoord van de API-gebruiker A, 20 4 (leeg laten) 5 De naam van de API-gebruiker A, 20 Bestandsinformatie: OHF Positie Veld Formaat 1 Vaste waarde: 'OHF'. Dit geeft aan dat de regel bestandsinformatie bevat / 2 aam van het ingediende bestand A, 50 3 Vaste waarde: 'MTR'. Dit geeft aan dat een onderhoudsbewerking wordt uitgevoerd op een bestaande transactie / Page 12 of 14-09/09/2017
Positie Veld Formaat Bewerkingscode: 4 RFD = gedeeltelijke terugbetaling RFS = (laatste) gedeeltelijke of volledige terugbetaling A, 3 5 Aantal transacties dat door het huidige bestand wordt beïnvloed Transactie-informatie: MTR Positie Vield Formaat 1 Vaste waarde: 'MTR'. Dit geeft aan dat de regel transactie-informatie bevat / 2 Munteenheid A, 3 3-8 (leeg laten) 9 PAID, de unieke referentie die door ons systeem wordt gegenereerd en aangeboden in de initiële feedback over de transactie Bewerkingscode: 10 RFD = gedeeltelijke terugbetaling RFS = (laatste) gedeeltelijke of volledige terugbetaling A, 3 11-13 (leeg laten) 14 PSPID, de unieke identificatie van de handelaar op ons platform 15 (leeg laten) 16 Aantal detailregels voor de huidige transactie 17-33 (leeg laten) 34 Bedrag van de bewerking, vermenigvuldigd met 100 Regeldetails:DET Positie Veld Formaat 1 Vaste waarde: 'DET'. Dit geeft aan dat de regel een detailregel bevat / 2 Hoeveelheid 3 Item-ID A, 15 Page 13 of 14-09/09/2017
Positie Veld Formaat 4 Itemnaam A, 30 5 Eenheidsprijs van het item, vermenigvuldigd met 100 om afrondingsproblemen te vermijden 6 Geeft aan of de prijs geldt: 1 inclusief btw of 0 exclusief btw A, 1 7 Btw-voet, in de vorm van een percentage (inclusief het symbool %) Dit is vereist, zelfs als het bedrag inclusief btw is % 8-15 (leeg laten) Einde van bestand:otf Positie Veld Formaat 1 Vaste waarde: 'OTF'. Dit geeft aan dat dit de laatste regel van het bestand is / 5.2.2 Voorbeeld OHL;[your pspid];[your password];;[your username]; OHF;[file name];mtr;rfd;1; MTR;EUR;;;;;;;[PAID];RFD;;;;[your pspid];;1;;;;;;;;;;;;;;;;;;119; DET;1;2;first item;119;1;19%;;;;;;;; OTF; Gedeeltelijk onderhoud: Merk op dat het voorbeeld op dezelfde manier van toepassing is voor gedeeltelijke/meervoudige onderhoudsactiviteiten. Dit betekent dat ook de regelitemdetails verplicht zijn in bijvoorbeeld aanvragen voor gedeeltelijke terugbetaling. Ga voor meer informatie naar Batch. Page 14 of 14-09/09/2017