Print Providers - Prodigi

Using Prodigi print fulfilment with DPG

This guide covers the first release of DPG print fulfilment. In this release, Prodigi is the provider with the live end-to-end order submission flow.

Open Services Open Sales Prodigi API docs

What this integration does

With Prodigi connected, DPG can:

  • show print-enabled product options on the website
  • collect the shipping address and shipping phone number at checkout
  • create the normal DPG website order after Stripe or PayPal payment
  • submit the print order to Prodigi automatically
  • show fulfilment status, provider reference and tracking in the DPG Sales order view

Customer payment still goes through your DPG website checkout. Prodigi is used for fulfilment after payment, not as the customer payment processor.

Before you start

  • You must be signed in as an administrator. Only administrators can see Services > Print Providers.
  • You need a Prodigi account and API key.
  • For testing, Prodigi provides separate Sandbox and Live environments.
  • Your product option should normally use Type: Standard. Do not use Image for a print option unless you intentionally want DPG digital-image behaviour.

If no active print provider account has been connected in Services, DPG hides the print-provider controls elsewhere to avoid confusion.

Step 1: Connect Prodigi in Services

  1. Open Services.
  2. Open the Print Providers section.
  3. Click Connect.
  4. Choose Provider: Prodigi.
  5. Complete the fields:
  • Label: optional internal name for this connection
  • Environment: Sandbox / Test for testing, or Production for live orders
  • Provider account reference: optional external account id or note
  • API key: required
  • Webhook secret: optional in the current DPG release
  • Active: enabled for live use inside DPG
  1. Save the connection.

DPG allows one Prodigi account per DPG account per environment. That means you can keep one sandbox connection and one production connection if needed.

Step 2: Create or edit the product option

  1. Open Sales.
  2. Edit the product you want to sell as a print.
  3. In Product Options, add or edit the option that should be sent to Prodigi.
  4. Set the option like this:
  • Type: Standard
  • Fulfilment: Print provider
  • Cost: your customer-facing selling price
  • Status: for example In stock
  1. Save the product.
  2. Re-open the product editor.

After you switch an option to Print provider, DPG treats it as a shipped item. Checkout will require a shipping address, and the shipping phone number will become required when the item is in the cart.

Step 3: Add the Prodigi mapping

After the product has been saved with a print-provider option, the Print Provider Mappings section appears.

For each print option you want to fulfil with Prodigi:

  • Provider: choose your Prodigi connection
  • Mode: choose Remote asset URL
  • SKU: enter the Prodigi SKU to fulfil
  • Product id: optional in the current Prodigi flow
  • Variant id: optional in the current Prodigi flow
  • Print area: usually default
  • Sizing: Fill print area, Fit print area or Stretch to print area

Save the product again after adding the mapping.

The Prodigi adapter currently uses the SKU, Print area and Sizing values. Product id and Variant id can still be stored for your own reference, but they are not required for the initial Prodigi submission flow.

How artwork is sent to Prodigi

DPG sends Prodigi the original image asset URL at order time.

This means:

  • the ordered DPG image must still have an original image version available
  • the print option must have a valid Prodigi SKU
  • the product option must stay mapped to an active Prodigi provider account

If the original image asset URL is missing, DPG cannot submit the print order to Prodigi. The order will remain in DPG and the print fulfilment section will show the error.

Step 4: Test the full flow

For a safe test:

  1. Connect a Sandbox / Test Prodigi account in Services.
  2. Map one product option to a sandbox-compatible Prodigi SKU.
  3. Add the product to a test website or test page where it is visible.
  4. Place a website order.
  5. Complete checkout and include a shipping phone number.
  6. Open the order in Sales.

In the order view, look for the Print fulfilment section. You should see:

  • provider name
  • DPG or provider reference
  • fulfilment status
  • tracking, once available
  • any error returned by DPG or Prodigi

Expected order statuses

You may see these statuses in DPG:

  • pending submission: DPG has created the provider-order record but has not submitted it yet
  • configuration required: DPG is missing a valid SKU, artwork URL or mapping
  • submission failed: DPG tried to submit the order and Prodigi rejected it or the request failed
  • submitted: Prodigi accepted the order
  • in production: Prodigi has started processing the order
  • dispatched: shipment has been created
  • completed: the provider has completed the order
  • cancelled: the provider marked the order as cancelled

Troubleshooting

The Print Providers section is missing

  • Make sure you are signed in as an administrator.

The Print provider fulfilment option is missing in Product Options

  • DPG only shows that option after at least one active print provider account has been connected.

The product option does not appear on the website

  • The option must be active.
  • It must have Fulfilment: Print provider.
  • It must have an active provider mapping.

The order was paid, but no Prodigi order was created

  • Check the Sales order page for a Print fulfilment error.
  • The most common causes are a missing SKU or a missing original image asset URL.

The shipping phone number was required at checkout

  • That is expected for print-provider orders in the current DPG release.

What should I use for Type?

  • For a print product, use Type: Standard.
  • Use Type: Image only for DPG image-order or digital-image behaviour, not for print-provider fulfilment.
  • Test with Prodigi sandbox first.
  • Keep one simple print option live before expanding to many sizes or materials.
  • Use clear internal labels for your provider accounts so staff can tell test and live accounts apart.
  • Check the first few orders manually in both DPG and Prodigi before wider rollout.
Article short link: https://dpg.support/aeng