Custom Gateway Integration


Integration Settings
Product Settings
Shipping Class Match
Sending Orders to Custom Gateway


Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to Custom Gateway for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk automatically.

This guide explains how to set up and use the Custom Gateway integration.


To connect to Custom Gateway, click on the Manage Integrations link under the Integrations menu in the left sidebar, and under the Print on Demand tab find and enable Custom Gateway.

Enter your Custom Gateway API Key and company ID then click to connect.

To find your Custom Gateway credentials, please contact your rep from Custom Gateway. Order Desk support is not able to help with finding or resetting your Custom Gateway credentials, as they are created and provided by Custom Gateway.

Integration Settings

Once connected, you'll have some shipment and integration settings to adjust per your preferences.

Default Mail Class

Choose the mail class you want Custom Gateway to use for your orders.

If you need to apply specific methods for certain orders, match your method names to the names Custom Gateway uses in the Shipping Class Match section below.

After Import, Move To

Select the folder you want orders to be moved into after they are successfully sent to Custom Gateway.

You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.

After Shipment, Move To

Select the folder you want orders to be moved into after Custom Gateway sends shipment details back to Order Desk.

Product Settings

For more information on what these product settings within the Custom Gateway integration are for, please refer to the Print on Demand Product Settings guide.

Shipping Class Match

If the shipping methods you set up in your shopping cart(s) don't match the shipping method names Custom Gateway uses, they won't know what methods you intend for them to use. When this happens, the default mail class applied above will be used instead for all of your orders.

To tell Custom Gateway what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the shipping class match guide.

Sending Orders to Custom Gateway

Initially, getting your orders ready to send to Custom Gateway is going to take some time before everything is in place for it to happen automatically. For detailed instructions on how to use Order Desk with your print on demand orders, please take a few moments to read the Print on Demand Fulfillment guide.

Preparing Item Details

The following fields can be set as variations or item metadata for each item in an order:

Field Name Field Value
print_sku Required. Custom Gateway product ID.
textual_product_id Textual Product ID. Will be provided by Custom Gateway.
print_url URL of the artwork file. For multi-location prints, use print_url_1 through print_url_7. Required if a print_design_id is not used.
print_design_id To send a print job or a print on demand job, enter the ID in this field.
print_preview Optional. Use print_preview or image to send a preview of artwork.
print_type The type of print. Default is 1. If print_url_2 is set, this will automatically be converted to 7. If type 2 or type 3 is used, please set print.
size Garment size, if applicable.
color Garment color, if applicable.
print_job_ref A unique identifier linking this item to an already existing print job.

Preparing Order Details

The following fields can be set as checkout data or order metadata to change what gets sent to Custom Gateway:

Field Name Field Value
PackingSlip URL for the PDF to be included as the packing slip with the order. Details here.

If you are unfamiliar with checkout data, please first read the How to Work with CheckoutData guide.

Still need help? Contact Us Contact Us