Custom Gateway Integration

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.


Integration Settings
Product Settings
Shipping Class Match
Custom Details for Custom Gateway


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.

Alternatively, search for Custom Gateway from the available integration search.

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

Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be 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.

If Canceled, Move To

Select the folder you want orders to be moved into if they are canceled at Custom Gateway.

Include Item Prices in Submission

Enable to send item prices to Custom Gateway when submitting an order. 

If enabled, use the order metadata field skip_price_export set to 1 to prevent the item prices from being sent to Custom Gateway on specific orders. Details below.

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.

Custom Details for 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_location_x Use to set the location of the print on your item. Up to 7 (e.g. print_location_1, print_location_2)
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.
external_thumbnail_url Used for setting an external URL for your thumbnail images. Note that this will only work when print_type is set to 5.

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.
skip_price_export If the default Include Item Prices in Submission setting is enabled above, set this field to 1 to prevent the item prices from being sent to Custom Gateway on specific orders.

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

Still need help? Contact Us Contact Us