Bol.com afrekenen

afrekenen nieuwe stijl

Bol.com afrekenen biedt externe ontwikkelaars en partners de mogelijkheid om hun bezoekers snel te laten afrekenen bij bol.com. De schermen zijn specifiek opgezet voor mobiele sites en (tablet)apps maar werken ook prima op desktop sites.

Account aanmaken - bol.com afrekenen v2

Alle functionaliteiten

Voor de klant:

  • Inloggen met je bol.com account
  • Bol.com account aanmaken
  • Nieuwe adressen toevoegen voor facturatie en bezorging
  • Bezorgafspraak maken voor groot huishoudelijke artikelen
  • Een alternatieve bezorgdatum kiezen bij levertijd ‘vandaag besteld, morgen in huis’
  • Responsive layout voor tablets en desktops
  • Gebruikers blijven ingelogd voor wat betreft de winkelwagen. Voor het afrekenen moeten zij wel opnieuw inloggen indien zij 19 minuten niet hebben ingelogd.
  • Aankopen kunnen gedeeld worden op social vanaf de bestelbevestiging (alleen bij bestellingen met 1 artikel)
  • Automatisch samenvoegen van producten die reeds in de winkelwagen stonden
  • Het aanpassen van de winkelwagen (aantallen aanpassen, producten verwijderen)
  • Factuur- of bezorgadressen kiezen uit de beschikbare adressen of nieuwe adressen toevoegen
  • Wachtwoord vergeten/instellen nieuw wachtwoord
  • Afrekenen van bol.com producten, tweedehands producten en plaza producten
  • 5 Dagen cookietijd en winkelwagen tracking voor het bol.com partnerprogramma

Acceptgiro betalen - bol.com afrekenen v2

Betaalmethodes:

  • iDEAL (alleen voor gebruikers met een geldig Nederlands adres)
  • Creditcard (alleen bestaande creditcards in de account van de gebruiker)
  • Acceptgiro (afhankelijk van bestelling en klant)
  • Automatische incasso (alleen bij ebooks)
  • Mister Cash/Bancontact (alleen voor Belgische klanten)

Welke betaalmethodes uiteindelijk beschikbaar zijn binnen een order hangen naast bovenstaande factoren ook af van het type artikelen en de historie van de klant.

Voor de Developer:

  • Deeplinken met meerdere stuks van één artikel
  • Een eigen logo tonen in bol.com afrekenen
  • De tekst van de returnurl kunnen opgeven (vanaf begin juli 2013)
  • Er kan een width in pixels worden meegegeven aan bol.com afrekenen

Hoe gebruik je bol.com afrekenen?

Er zijn twee scenario’s om bol.com afrekenen aan te roepen:

  1. Met een add-to-basket deeplink met daarin de offerid’s en het aantal
  2. Met een add-to-basket deeplink met daarin het openapisessionid van een eerder aangemaakte winkelwagen (lees hier meer over het aanmaken van een anonieme winkelwagen)

Add-to-basket deeplink

De makkelijkste manier om bol.com afrekenen te gebruiken is om rechtstreeks een deeplink aan te roepen met daarin de offerid’s en bijbehorende aantallen als parameters. Binnen dit scenario selecteert een gebruiker op een site of binnen een app één of meer producten en kiest voor “afrekenen bij bol.com”. De apps/site linkt de gebruiker door en de gebruiker landt op een overzichtsscherm met de producten die zijn meegegeven en begint met het afrekenproces. De sessie van de gebruiker wordt voor 20 minuten opgeslagen in een cookie, zodat de gebruiker ook heen en weer tussen app/site en afrekenproces kan gaan. Mocht de gebruiker dus terug gaan naar de app/site en vervolgens een nieuw product erbij willen plaatsen, dan zullen ook de eerdere toegevoegde producten zichtbaar zijn in de winkelwagen. Als de gebruiker eenmaal is ingelogd en dan terug gaat naar de app en wederom deeplinkt met producten komen die in zijn ingelogde winkelwagen terecht (inlogperiode is voor 12 maanden).

Een voorbeeld van een volledige aanroep:

https://afrekenen.bol.com/nl/winkelwagentje/direct-toevoegen?returnurl=http://www.mijnurl.nl&name=Mijn+Testapp&logoid=51&id=1001004002126206:2,9200000002308104&siteid=123456

We ondersteunen een aanroep via het reguliere clickout mechanisme van het bol.com partnerprogramma. Hierbij kun je een name en subid meegeven die in je rapportage in het partnerprogramma terug komt. Let op dat de waarde van de queryparameter url ook url-encoded is en vul op 2 plaatsen je siteid in (in dit voorbeeld 123456). Een voorbeeld van een volledige aanroep via de bol.com partnerprogramma redirect:

http://partner.bol.com/click/click?p=1&t=url&s=123456&f=API&url=https%3A%2F%2Fafrekenen.bol.com%2Fnl%2Fwinkelwagentje%2Fdirect-toevoegen%3Freturnurl%3Dhttp%3A%2F%2Fwww.mijnurl.nl%26name%3DMijn%2BTestapp%26logoid%3D51%26id%3D1001004002126206%3A2%26siteid%3D123456

Add-to-basket deeplink met openapisessionid van een anonieme winkelwagen

Als alternatief kunnen producten via de Open API aan een winkelwagen (basket) worden toegevoegd, buiten de module bol.com afrekenen om. Als de call addtobasket wordt aangeroepen wordt er een anonieme winkelwagen aangemaakt. Deze is niet gekoppeld aan een bol.com gebruiker en verloopt na 20 minuten inactiviteit. De winkelwagen is gekoppeld aan een Open API sessie. Als de Open API sessie als parameter wordt meegegeven aan de add-to-basket deeplink bij bol.com afrekenen, worden de producten getoond aan de gebruiker. Zodra de gebruiker inlogt, worden de producten aan de ingelogde winkelwagen van de gebruiker toegevoegd.

Een voorbeeld van een volledige aanroep via de bol.com partnerprogramma redirect:

http://partner.bol.com/click/click?p=1&t=url&s=123456&f=API&url=https%3A%2F%2Fafrekenen.bol.com%2Fnl%2Fwinkelwagentje%2Fdirect-toevoegen%3Freturnurl%3Dhttp%3A%2F%2Fwww.mijnurl.nl%26name%3DMijn%2BTestapp%26logoid%3D51%26openapisessionid%3DC2135675-E302-4D55-AF5D-E9CF8E35C7A8%26siteid%3D123456

Parameters

Parameter Required Additional constraints Description
id or ids False Valid bol.com offer ID Used for adding products to the checkout by bol.com basket. Multiple offers can be used in a single call by separating the offer ids with a , (comma).
Example: 1000004013713988:2
openapisessionid False None If the basket api call was used, the sessionId of the Open API session must be included with the call to afrekenen.bol.com in order to identify the anonymous basket to which the items were added.
returnurl False URL including protocol (e.g. http://www.test.com) The Checkout by bol.com allows a return url that the customer can use to navigate back to the original app or website. The return url will be included on a number of screens.
name False Plain text, RFC2396 encoded, HTML not supported This parameter is used to pass along a name that is used to present the return url on a number of screens (see earlier screenshots)
siteid True Numeric Use this parameter to pass along the siteid of the bol.com affiliate program (in this manual the example 123456 is used). This id is stored in a cookie that is valid for 5 days
width False Numeric This parameter can be used to force a max width in pixels for the checkout. Please note that the min-width will always be 320 pixels. Also note that a responsive layout is triggered by the width of the container window, so a very small width in a big browserwindow might result in a bad layout.
logoid false Numeric The id of the custom logo in the checkout. Please note that your logo will be downsized to 50% to be ready for retina screens.Logo requirements:filetype: pngfilesize: max 100 kbwidth: minimum is 70 pixels, maximum is 400 pixelsheight: must be 70 pixels highPlease send your logo and the siteid that you are using (if you are a partner with the bol.com affiliate program) to developercenter@bol.com and we will give you a confirmation when the logo is live.

Koppeling met het partnerprogramma

Bol.com afrekenen werkt samen met het bol.com partnerprogramma. Door de parameter “siteid” te vullen met het siteId van het bol.com partnerprogramma zullen alle orders die binnen de normale voorwaarden van het partnerprogramma verkocht worden aan de partner worden toegeschreven.

Tips

  • Je kunt bol.com afrekenen gebruiken als winkelwagen om een klant te laten zien wat de totaalprijs is van een reeks producten, doordat eventuele verzendkosten en promotionele acties direct zichtbaar zijn.
  • Bewaar eventueel lokaal op je eigen site of in je eigen app de producten die een klant wil afrekenen, nadat er op afrekenen geklikt is. Indien de winkelwagen verloopt (na 20 minuten), doordat een klant bijvoorbeeld niet het hele afrekenproces afmaakt, moeten de producten opnieuw met een deeplink worden toegevoegd.
  • Maak handig gebruik van de returnurl die als parameter opgegeven kan worden. Dit kan bijvoorbeeld leiden naar een vervolgpagina of een eigen bedankpagina.
  • Maak voor de zekerheid gebruik van url-encoded deeplinks

Vragen?

Stel je vragen in het speciale forum voor bol.com afrekenen.
Responsive design voor o.a. tablets - bol.com afrekenen v2
volg developers.bol.com via TwitterMeld je aan voor de Partnerprogramma groep op Linkedin