Why use the Checkout API
Delivery options
To provide the possible day(s) of delivery, timeframes and PostNL pickup locations to display in the checkout of a webshop. Based on the address of the customer, orderdate and specified delivery options, you get timeframes and nearest PostNL pickup locations in the response.
Customer convenience
Enhance your customer's online shopping experience by providing more control over the delivery of their purchased product. Integrate the PostNL frontend webservices into your checkout and empower your customers to choose the delivery option that suits them best.
More information and control
To give your customers more information and control about the arrival of the parcels. Using the Checkout API gives your customers more information and control about the arrival of the parcels. But it is good to realize that it gives you, the webshop, also a responsibility to deliver the parcel on time by PostNL.
Get started
Documentation
View our exhaustive documentation.
Postman
All of our API's available as Postman collections.
Github
Find PostNL on Github.
Sandbox
Rest your integration by copying the endpoint.
Guidelines
Learn more about the Checkout API guidelines.
Use of the webservice
This API can be used to fill a webshop’s checkout page.
Warnings
Warnings are returned when there is a functional problem with the request (e.g. when an address is not recognized, or when no delivery options are available).
Sundays and public holidays
This service takes into account ‘non-business’ days like Sundays and public holidays.
Holiday sorting
It is possible to allow for holiday sorting. With holiday sorting enabled, you can tell PostNL that you will be able to deliver the parcel to PostNL during holidays.
Delivery options
It is possible to specify which delivery options should be considered. The possible values are:
Option | Description |
---|---|
Daytime | Daytime delivery |
Evening | Evening delivery |
Today | Delivery on day of handover to PostNL |
08:00-09:00 | Guaranteed delivery between the timeframe specified |
08:00-10:00 | Guaranteed delivery between the timeframe specified |
08:00-12:00 | Guaranteed delivery between the timeframe specified |
08:00-17:00 | Guaranteed delivery between the timeframe specified |
Pickup | Pickup at PostNL location |
All the above delivery options can be used in the request of the Checkout API. PostNL will charge an additional amount for delivery of the parcels with the options Evening, Morning, (After)Noon, Delivery on demand, Guaranteed delivery and Today. For specific costs and the activation of this delivery options, it is recommended to consult your PostNL Pakketten account manager. For Today delivery it is even mandatory to consult your account manager.
* The Today delivery option will be returned on any given day (Mon – Sun), but will only be on the first following business day.
Visual Assets
The Visual Assets can be useful to create a delivery options frame in your checkout.