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.
[ { "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" } ] }]