PUT /checkout/v4/referrers

Adds or updates the referrer of the current session. Note: Usage of this call is limited and only on request by email to developercenter@bol.com.

Request URL structure:
https://api.bol.com/checkout/v4/referrers/{referrerCode}

Make sure that the parameter values are urlencoded.

Request HTTP method:
PUT

Request requires session:
X-OpenAPI-Session-ID HTTP header is required.

Request parameters:

Name

Location

Data type

Required

Description

referrerCode

Path

Number

Yes

Referrer code (format: ADVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

To retrieve the referrer code:

http://partnerprogramma.bol.com/click/click?p=1&t=url&s={siteid}&url={externalUrl}&f=API&subid={id}&name={naam}

for instance:

http://partnerprogramma.bol.com/click/click?p=1&t=url&s={siteId}&url=http%3A//www.bol.com&f=API&subid=API&name=ResolveToReferrer

will redirect to

http://www.bol.com/nl/index.html?Referrer=ADVNLPP7bfa4307e9a8e54ddb84891cedd20000401

The URL part after Referrer can then be used. This referrer code is only valid for the cookie time specified here (Dutch)

 

Response XML:

Element

Min

Max

Description

No XML response is returned.

 

Request / Response example:

Request: https://api.bol.com/checkout/v4/referrers/ADVNLPP7bfa4307e98df952db84891c4ab30000401

Response HTTP status code: 200