1. Home
2. Betaalmethoden
3. Alternatieve betaalmethoden
4. Riverty

1. Inleiding

Dit document geeft informatie over de integratie met Gehoste betaalpagina en het gebruik van de Riverty-betaalmethode.

2. Integratie met Gehoste betaalpagina

U dient bij elke bestelling een aantal bijkomende parameters te verzenden. Dit is alleen mogelijk met een POST-aanvraag.

2.1 Standaard Worldline-velden

De volgende parameters kunnen of moeten voor elke transactie worden ingediend:

Veld	Beschrijving	Formaat	Verplicht
AMOUNT	Totaal bedrag van de bestelling (inclusief btw), vermenigvuldigd met 100 (om problemen met decimalen te vermijden), dus 1,00 x 100 --> 100	N	Y
CURRENCY	Alpha-ISO-code van de munteenheid (EUR, GBP, CHF, enz.)	AN, 3	Y
LANGUAGE	Gelokaliseerde taal van de klant (nl_NL, nl_BE, fr_FR, enz.) Indien niet ingediend, wordt de standaardtaal Engels gebruikt.	AN, 5	N
OPERATION	Definieert het soort aanvraag, waarbij de standaardbewerkingscode wordt genegeerd	Values: RES / SAL	N
ORDERID	De unieke referentie van uw bestelling	AN, 40	Y
PSPID	Uw unieke identificatie in het systeem	AN, 30	Y

2.2 Facturatie- en leveringsgegevens

De volgende parameters kunnen of moeten met elke bestelling voor Riverty worden ingediend:

Veld	Beschrijving	Formaat	Verplicht
CIVILITY	Titel (M/V) factuur	AN, 10	Y
ECOM_BILLTO_POSTAL_NAME_FIRST	Voornaam factuur	AN, 35	Y
ECOM_BILLTO_POSTAL_NAME_LAST	Achternaam factuur	AN, 35	Y
OWNERADDRESS	Straatnaam factuur	AN, 35	Y
ECOM_BILLTO_POSTAL_STREET_NUMBER	Huisnummer factuur	AN, 10	Y
OWNERZIP	Postcode factuur	AN, 10	Y
OWNERTOWN	Stad factuur	AN, 25	Y
OWNERCTY	Landcode (BE, FR, NL, DE, enz.) factuur	AN, 2	Y
EMAIL	E-mailadres factuur	AN, 50	Y
OWNERTELNO	Telefoonnummer factuur	AN, 30 (Riverty accepts max. 10)	Y
ECOM_SHIPTO_POSTAL_NAME_PREFIX	Aanspreking (Mr., Mevr., enz.) levering	AN, 10	N
ECOM_SHIPTO_POSTAL_NAME_FIRST	Voornaam levering	AN, 35	Y
ECOM_SHIPTO_POSTAL_NAME_LAST	Achternaam levering	AN, 35	Y
ECOM_SHIPTO_POSTAL_STREET_LINE1	Adres levering	AN, 35	Y
ECOM_SHIPTO_POSTAL_STREET_NUMBER	Huisnummer levering	AN, 10	Y
ECOM_SHIPTO_POSTAL_POSTALCODE	Postcode levering	AN, 10	Y
ECOM_SHIPTO_POSTAL_CITY	Stad levering	AN, 25	Y
ECOM_SHIPTO_POSTAL_COUNTRYCODE	Landcode (BE, FR, NL, DE, enz.) levering	AN, 2	Y
ECOM_SHIPTO_ONLINE_EMAIL	E-mailadres levering	AN, 50	N
ECOM_SHIPTO_DOB	Geboortedatum klant levering	dd/mm/yyyy	Y
DATEIN	Datum en tijd levering	mm/dd/yyyy hh:mm:ss	N
ORDERSHIPMETH	Leveringsmethode	AN, 25	N
ORDERSHIPCOST	Leveringskost, exclusief btw Bedrag vermenigvuldigd met 100	N, 10	N
ORDERSHIPTAX	Bedrag belasting levering Bedrag vermenigvuldigd met 100	N	N
ORDERSHIPTAXCODE	Belastingscode (bijv. 19%) levering	, 10	N
Extra parameters voor B2B
REF_CUSTOMERREF	Nummer Kamer van Koophandel (KVK)	AN, 20	Y
ECOM_SHIPTO_COMPANY	Leveringsbedrijf	AN, 50	Y
ECOM_SHIPTO_TVA	Btw-nummer	AN, 20	Y
REF_CUSTOMERID	Klantennummer	AN, 17	N
COSTCENTER	Afdeling van het bedrijf	AN, 20	N

2.3 Bestelgegevens

De volgende parameters kunnen of moeten met elke bestelling voor Riverty worden ingediend:

Veld	Beschrijving	Formaat	Verplicht
ITEMIDx	Identificatie van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMID1, ITEMID2 enz.)	AN, 15	Y
ITEMNAMEx	Naam van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMNAME1, ITEMNAME2 enz.)	AN, 40	Y
ITEMPRICEx	Prijs van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMPRICE1, ITEMPRICE2 enz.)	N, 15	Y
ITEMQUANTx	Aantal items (vervang "x" door een getal om meerdere items te verzenden: ITEMQUANT1, ITEMQUANT2 enz.)	N, 15	Y
ITEMCATEGORYx	Aantal items (vervang "x" door een getal om meerdere items te verzenden: ITEMQUANT1, ITEMQUANT2 enz.)	AN, 50	N
ITEMVATCODEx	Btw-code van het item (vervang "x" door een getal om meerdere items te verzenden: ITEMVATCODE1, ITEMVATCODE2 enz.)	percentage	Y
TAXINCLUDEDX	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: TAXINCLUDED1, TAXINCLUDED2 enz.)	N: 1	N

Opmerking: Het totale bedrag moet worden vermenigvuldigd met 100 om verwarring rond het decimaalteken te vermijden. Deze techniek wordt echter NIET 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. (NIET toegepast)

2.4 Voorbieeld

Het volgende formulier simuleert een Riverty-transactie met alle vereiste velden.

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 Worldline fields --> <input type="text" name="ORDERID" value ="order123"/><br/> <input type="text" name="AMOUNT" value ="1309"/><br/> <input type="text" name="LANGUAGE" value="nl_NL"/><br/> <input type="text" name="PSPID" value="[yourpspid]"/><br/> <input type="text" name="CURRENCY" value="EUR"/><br/> <!-- Invoicing Information --> <input type="text" name="CIVILITY" value ="M"/><br/> <input type="text" name="ECOM_BILLTO_POSTAL_NAME_FIRST" value ="John"/><br/> <input type="text" name="ECOM_BILLTO_POSTAL_NAME_LAST" value ="Doe"/><br/><br/> <input type="text" name="OWNERADDRESS" value ="test street"/><br/> <input type="text" name="ECOM_BILLTO_POSTAL_STREET_NUMBER" value ="66"/><br/> <input type="text" name="OWNERZIP" value ="3000 AA"/><br/> <input type="text" name="OWNERTOWN" value ="Rotterdam"/><br/> <input type="text" name="OWNERCTY" value ="NL"/><br/> <input type="text" name="OWNERTELNO" 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_NAME_FIRST" value ="John"/><br/> <input type="text" name="ECOM_SHIPTO_POSTAL_NAME_LAST" value ="Doe"/><br/><br/> <input type="text" name="ECOM_SHIPTO_POSTAL_STREET_LINE1" value ="postal street"/><br/> <input type="text" name="ECOM_SHIPTO_POSTAL_STREET_NUMBER" value ="66"/><br/> <input type="text" name="ECOM_SHIPTO_POSTAL_POSTALCODE" value ="3000 AA"/><br/> <input type="text" name="ECOM_SHIPTO_POSTAL_CITY" value ="Rotterdam"/><br/> <input type="text" name="ECOM_SHIPTO_POSTAL_COUNTRYCODE" value ="NL"/><br/> <input type="text" name="ECOM_SHIPTO_ONLINE_EMAIL" value ="john@doe.com"/><br/> <!-- order details, item 1 --> <input type="text" name="ITEMID1" value ="1"/><br/> <input type="text" name="ITEMNAME1" value ="first item"/><br/> <input type="text" name="ITEMPRICE1" value ="11.90"/><br/> <input type="text" name="ITEMQUANT1" value ="1"/><br/> <input type="text" name="ITEMVATCODE1" value ="19%"/><br/> <input type="text" name="TAXINCLUDED1" value ="1"/><br/> <!-- order details, item 2 --> <input type="text" name="ITEMID2" value ="2"/><br/> <input type="text" name="ITEMNAME2" value ="Shipping costs"/><br/> <input type="text" name="ITEMPRICE2" value ="1.00"/><br/> <input type="text" name="ITEMQUANT2" value ="1"/><br/> <input type="text" name="ITEMVATCODE2" value ="19%"/><br/> <input type="text" name="TAXINCLUDED2" value ="0"/><br/> <!-- B2B parameters (if applicable) --> <input type="text" name="REF_CUSTOMERREF" value ="12345"/><br/> <input type="text" name="ECOM_SHIPTO_COMPANY" 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="COSTCENTER" value = "Finance"/><br/> <!-- don't forget your SHA-IN signature! --> SHASIGN<input type="text" name="SHASIGN" value="[your SHA-IN signature]"/><br/> <input type="submit" value="submit"/> </form>

3. Feedback over de transactie

3.1 Bestelgegevens

Alle bestelgegevens kunnen worden bekeken in uw Worldline-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 NCERROR) 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

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.

5. Onderhoud

5.1 DirectLink

Onderhoudsactiviteiten (terugbetalingen en registraties) kunnen via DirectLink worden uitgevoerd.

Opmerking: U dient de optie Worldline DirectLink te activeren in uw Ogone-account om deze functie te gebruiken. Neem 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
AMOUNT	Totaal terug te betalen bedrag, inclusief btw.	N	Y
CURRENCY	Valuta van transactie (EUR, CHF, USD, GBP, enz.)	AN, 3	Y
OPERATION	Uit te voeren handeling. RFD = gedeeltelijke terugbetaling RFS = (laatste) gedeeltelijke of volledige terugbetaling Voor een volledige lijst van de mogelijke bewerkingen raadpleegt u het Parameter Cookbook in uw Worldline-account.	AN, 3	N
ORDERID	De unieke referentie van uw bestelling	AN, 30	Y
PAYID	Onze betaalreferentie, die na de initiële transactie naar u werd gestuurd	N	Y
PSPID	Uw unieke identificatie in het systeem	AN, 30	Y
PSWD	Het wachtwoord van de gebruiker	AN, 20	Y
USERID	De gebruiker die het onderhoud uitvoert. Dit is om beveiligingsredenen vereist. De gebruiker moet API-privileges hebben (raadpleeg de the User Manager - documentatie voor meer informatie)	AN, 20	Y

Veld	Beschrijving	Formaat	Verplicht
ITEMIDX	Identificatie van het item (vervang X door een getal om meerdere items te verzenden: ITEMID1, ITEMID2 enz.)	AN, 15	Y
ITEMNAMEX	Naam van het item (vervang X door een getal om meerdere items te verzenden: ITEMNAME1, ITEMNAME2 enz.)	AN, 30	Y
ITEMPRICEX	Prijs van het item (vervang X door een getal om meerdere items te verzenden: ITEMPRICE1, ITEMPRICE2, enz.)Vermenigvuldigd met 100 (in tegenstelling tot de originele indiening)	N	Y
ITEMQUANTX	Aantal items (vervang X door een getal om meerdere items te verzenden: ITEMQUANT1, ITEMQUANT2 enz.)	N	Y
ITEMVATCODEX	Btw-code van het item (vervang X door een getal om meerdere items te verzenden: ITEMVATCODE1, ITEMVATCODE2 enz.)	Percentage	Y
TAXINCLUDEDX	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 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: TAXINCLUDED1, TAXINCLUDED2 enz.) (vervang X door een getal om meerdere items te verzenden: TAXINCLUDED1, TAXINCLUDED2 enz.)	0 or 1	N

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="PAYID" value="[payid] "/><br/> <input type="text" name="ORDERID" value="[order id]"/><br/> <input type="text" name="AMOUNT" value="119"/><br/> <input type="text" name="OPERATION" value="RFD"/><br/> <input type="text" name="CURRENCY" value="EUR"/><br/> <input type="text" name="ITEMID1" value="1"/><br/> <input type="text" name="ITEMNAME1" value="first item"/><br/> <input type="text" name="ITEMPRICE1" value="119"/><br/> <input type="text" name="ITEMQUANT1" value="1"/><br/> <input type="text" name="ITEMVATCODE1" value="19%"/><br/> <input type="text" name="TAXINCLUDED1" 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

OHL;[your pspid];[your password];;[your username]; OHF;[file name];MTR;RFD;1; MTR;EUR;;;;;;;[PAYID];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 Worldline Batch te activeren in de Worldline-account om deze functie te gebruiken. Neem 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	AN, 20
4	(leeg laten)
5	De naam van de API-gebruiker	AN, 20

Bestandsinformatie: OHF

Positie	Veld	Formaat
1	Vaste waarde: 'OHF'. Dit geeft aan dat de regel bestandsinformatie bevat	/
2	Naam van het ingediende bestand	AN, 50
3	Vaste waarde: 'MTR'. Dit geeft aan dat een onderhoudsbewerking wordt uitgevoerd op een bestaande transactie	/
4	Bewerkingscode: RFD = gedeeltelijke terugbetaling RFS = (laatste) gedeeltelijke of volledige terugbetaling	AN, 3
5	Aantal transacties dat door het huidige bestand wordt beïnvloed	N

Transactie-informatie: MTR

Positie	Vield	Formaat
1	Vaste waarde: 'MTR'. Dit geeft aan dat de regel transactie-informatie bevat	/
2	Munteenheid	AN, 3
3-8	(leeg laten)
9	PAYID, de unieke referentie die door ons systeem wordt gegenereerd en aangeboden in de initiële feedback over de transactie	N
10	Bewerkingscode: RFD = gedeeltelijke terugbetaling RFS = (laatste) gedeeltelijke of volledige terugbetaling	AN, 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	N
17-33	(leeg laten)
34	Bedrag van de bewerking, vermenigvuldigd met 100	N

Regeldetails:DET

Positie	Veld	Formaat
1	Vaste waarde: 'DET'. Dit geeft aan dat de regel een detailregel bevat	/
2	Hoeveelheid	N
3	Item-ID	AN, 15
4	Itemnaam	AN, 30
5	Eenheidsprijs van het item, vermenigvuldigd met 100 om afrondingsproblemen te vermijden	N
6	Geeft aan of de prijs geldt: 1 inclusief btw of 0 exclusief btw	AN, 1
7	Btw-voet, in de vorm van een percentage (inclusief het symbool %) Dit is vereist, zelfs als het bedrag inclusief btw is	N%
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;;;;;;;[PAYID];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.