Some products need your customer in the WHCC editor before you can order them. They carry completion: "editor" in the catalog. This page covers the handoff they share: getting an edit link, sending your customer to the editor and back, and knowing when they've finished.
What your customer does in the editor depends on the product, and its guide covers that: see Albums & Books. The examples use the test host, https://.
/v1/commerce/configured-products/{configuredProductId}/edit-linkReturns a link that opens one item in the WHCC editor. It's the route in the Quick Start's edit link section. Each album or book has its own editor, so ask for a link, with its own redirects, for each one.
complete and cancel are required. Each is { "text": "...", "url": "https://..." }. complete is where your customer lands after they finish, and cancel is where the editor's back arrow goes. Send a non-empty text: the editor can label its finish button with it.%EDITOR_ID% in the path or query string. WHCC replaces it with the item's configuredProductId, so https://yourdomain.com/return?checkout=12345&item=%EDITOR_ID% tells you which item came back. Don't put it in the URL's # fragment, which the editor can rewrite. If complete has no %EDITOR_ID%, the response carries a guidance[] entry with the code card.redirect.complete_missing_editor_id_token.true or false, returns 400.1
2
3
4
5
6
7
8
9
10
11
curl -X POST https://apis-stage.whcc.com/api/v1/commerce/configured-products/<CONFIGURED_PRODUCT_ID>/edit-link \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "WHCC-API-Version: 2026-10" \
-H "Content-Type: application/json" \
-d '{
"redirects": {
"complete": { "text": "Back to my cart", "url": "https://yourdomain.com/return?checkout=12345&item=%EDITOR_ID%&t=<ONE_TIME_TOKEN>" },
"cancel": { "text": "Cancel", "url": "https://yourdomain.com/cart?checkout=12345" }
},
"settings": { "hidePricing": true }
}'
1
2
3
4
5
{
"actions": {
"edit": { "url": "https://editor-stage.dragdrop.design/editor/<CONFIGURED_PRODUCT_ID>?token=β¦", "method": "GET" }
}
}
Send your customer's browser to actions.edit.url.
complete or cancel is missing, WHCC returns 400 with an invalidParams[] entry named redirects.complete or redirects.cancel.https, WHCC returns 400 with <label> must be an https URL.404.When your customer finishes, the editor waits for their work and any photo uploads to save, then sends their browser to your complete url with a GET, %EDITOR_ID% filled in. That redirect is the only signal you get. Finishing sends nothing else to WHCC or to you, and if your customer closes the tab, you won't hear from the editor at all.
complete url, read the item's configuredProductId from the %EDITOR_ID% you put there, and mark that item finished in your checkout. Submit only items you've marked finished.complete url each time you ask for an edit link, and accept a return only with the latest token for that item in that customer's checkout.cancel or closed the tab, the item isn't finished: ask for a fresh edit link and send them back.Rely on your own record of the complete redirect. The API's status doesn't tell you that your customer finished in the editor. For an album or book, also check calculate before you submit, as the Albums & Books guide describes.
Calculate and submit use what the editor saved, not what you sent to create. Your customer can change selections in the editor, so show them the price and selectionsSummary[] that calculate returns.
If an item needs more work, don't create it again. A new create makes a new, blank item, and the work your customer did stays on the old one. Ask for a fresh edit link and send them back to finish it.
Back to Top πBuild with our API
Start adding our products into your app today. You don't need to talk to us first. Platforms and individual photographers or studios building for their own business are all welcome. Test API key access is available for every WHCC account. New to WHCC? Create an account first.
Established businesses with existing print volume
Tell us about your business and the partnership you have in mind, and we'll be in touch.
Tell us about your business and the partnership you have in mind, and we'll be in touch.