Add To Cart

Once the user is done customizing the product(s), we will forward the user to the URL of your shopping cart. Added to that URL is a query parameter labelled fe_cart_url that passes the URL at which you can request the items that need to be added to the user's shopping cart. You can then make a GET request to that URL and will receive the response body referenced below.

Important: Make sure to validate that the domain of the received fe_cart_url matches with the expected value (*.fasteditor.com)

Response body

This response body is a JSON array with items, each having the following parameters:

Name	Description	DataType	Example
sku	The SKU of the created product as known by Partner.	String	101032-001#DigitalTransferOS#itemfront#100#50#3
projectKey	FastEditor’s Unique identifier for the finished copy of the project. This needs to be communicated back in the request in Sale Notification	Integer	1480
projectId	FastEditor's Unique Identifier for the project. This can be used with the Smartlink function to send the user back into the project.	Integer	615
pages	The number of pages in the project. This is mostly relevant for photo books and sets of prints.	Integer	46
quantity	Number of items to add to the shopping cart.	Integer	1
imageUrl	The URL of a thumbnail image of the project.	String	https://zecbotvh3i.execute-api.eu-west-1.amazonaws.com/staging/project-image/21/1480/WkLBs47TZOCbpRzxKjhg/1759747383
output	For logo products with multiple print areas. This provides an array of objects with parameters "previewUrls" and (optionally) "name"	Array<Object>	See output table below
price	Price for product as calculated by FastEditor. Cents as decimals.	Number	19.95
currency	3-letter ISO code for the currency that the price is communicated in	String	EUR
country	2-letter ISO code for the country linked to the user session	String	ES
language	ISO code for the active language in the editor	String	nl
customAttributes	Returns the customAttributes send to the POST - Create SmartlinkAPI endpoint	Object	`{ "quantity": 2 }`
addOnQuantity	For products like photo books, this provides the number of extra pages (on top of the base number of pages for the product)	Integer	8

Output

The output parameter in the response body will hold an array with all (used) print positions in the product. Each object in the array will have the following

Name	Description	DataType	Example
previewUrls	Provides the URL to the image showing the mockup of the print position	Array<string>	"[https://zecbotvh3i.execute-api.eu-west-1.amazonaws.com/staging/project-image/21/1480/WkLBs47TZOCbpRzxKjhg/1759747383?pageid=8ivi8IvIz7tfI9NqwlfVJ"]
printMethod	One of the (normalized) available print methods, see: Onboarding of Products	String	Digital transfer
name	Localized name of the print position	String	Front
pmsColors	Array of used PMS colors in the user's artwork	Array<string>	["PANTONE 353 C"]
supplierPrintMethodName	Print method name as defined in the original supplier data (non-normalized source data)	String	Digital transfer
supplierPrintMethodCode	Print method code as defined in the original supplier data (non-normalized source data)	String	Digital Transfer OS
supplierPrintAreaCode	Code for the print position as defined in the original supplier data (non-normalized source data)	String	item front
supplierPrintAreaName	Name for the print position as defined in the original supplier data (non-normalized source data)	String	item front

Example response

Below is an example response body that you can receive when making the GET request to the URL received through the fe_cart_url query parameter.

JSON
    
[  {    "sku": "101032-001#DigitalTransferOS#itemfront#100#50#3",    "projectId": 1480,    "projectKey": 615,    "pages": 1,    "quantity": 1,    "imageUrl": "https://zecbotvh3i.execute-api.eu-west-1.amazonaws.com/staging/project-image/21/1480/WkLBs47TZOCbpRzxKjhg/1759747383",    "price": 0,    "currency": "EUR",    "country": "ES",    "isQuantityMutable": true,    "language": "nl",    "customAttributes": [],    "output": [      {        "printMethod": "Digital transfer",        "previewUrls": [          "https://zecbotvh3i.execute-api.eu-west-1.amazonaws.com/staging/project-image/21/1480/WkLBs47TZOCbpRzxKjhg/1759747383?pageid=8ivi8IvIz7tfI9NqwlfVJ"        ],        "pmsColors": [          "PANTONE 353 C"        ],        "supplierPrintMethodName": "Digital transfer",        "supplierPrintMethodCode": "Digital Transfer OS",        "supplierPrintAreaCode": "item front",        "supplierPrintAreaName": "item front"      }    ]  }]
Copy

Last updated on

Was this page helpful?