How to Integrate Replit with Printful

1// Verify Printful API key and test connection
2const axios = require('axios');
3
4const printful = axios.create({
5  baseURL: 'https://api.printful.com',
6  headers: {
7    'Authorization': `Bearer ${process.env.PRINTFUL_API_KEY}`,
8    'Content-Type': 'application/json'
9  }
10});
11
12async function testConnection() {
13  const resp = await printful.get('/store');
14  console.log('Connected to Printful store:', resp.data.result.name);
15  console.log('Store ID:', resp.data.result.id);
16  console.log('Currency:', resp.data.result.currency);
17}
18
19testConnection().catch(err => {
20  console.error('Printful connection failed:', err.response?.status, err.response?.data?.error);
21  if (err.response?.status === 401) console.error('Check PRINTFUL_API_KEY in Replit Secrets.');
22});

1# catalog.py — Browse Printful catalog and store products (Python)
2import os
3import requests
4
5PRINTFUL_API_KEY = os.environ['PRINTFUL_API_KEY']
6
7def get_headers():
8    return {
9        'Authorization': f'Bearer {PRINTFUL_API_KEY}',
10        'Content-Type': 'application/json'
11    }
12
13def list_store_products(limit=20, offset=0):
14    """List products synced to your Printful store."""
15    resp = requests.get(
16        'https://api.printful.com/store/products',
17        headers=get_headers(),
18        params={'limit': limit, 'offset': offset}
19    )
20    resp.raise_for_status()
21    return resp.json()['result']
22
23def get_store_product(product_id):
24    """Get a single store product with all sync variants and their IDs."""
25    resp = requests.get(
26        f'https://api.printful.com/store/products/{product_id}',
27        headers=get_headers()
28    )
29    resp.raise_for_status()
30    return resp.json()['result']
31
32def list_catalog_products(limit=20):
33    """Browse Printful base catalog (blank products)."""
34    resp = requests.get(
35        'https://api.printful.com/products',
36        headers=get_headers(),
37        params={'limit': limit}
38    )
39    resp.raise_for_status()
40    return resp.json()['result']
41
42if __name__ == '__main__':
43    print('--- Store Products ---')
44    for p in list_store_products():
45        print(f"  [{p['id']}] {p['name']}")
46    print('\n--- Catalog (Base) Products ---')
47    for p in list_catalog_products():
48        print(f"  [{p['id']}] {p['title']}")

1// orders.js — Create Printful orders from Node.js on Replit
2const axios = require('axios');
3const express = require('express');
4
5const printful = axios.create({
6  baseURL: 'https://api.printful.com',
7  headers: {
8    'Authorization': `Bearer ${process.env.PRINTFUL_API_KEY}`,
9    'Content-Type': 'application/json'
10  }
11});
12
13const app = express();
14app.use(express.json());
15
16// Create a Printful order after successful payment
17async function createPrintfulOrder(customerData, cartItems) {
18  const orderBody = {
19    recipient: {
20      name: customerData.name,
21      address1: customerData.address1,
22      address2: customerData.address2 || '',
23      city: customerData.city,
24      state_code: customerData.stateCode,   // e.g., 'CA'
25      country_code: customerData.countryCode, // e.g., 'US'
26      zip: customerData.zip
27    },
28    items: cartItems.map(item => ({
29      sync_variant_id: item.printfulVariantId,
30      quantity: item.quantity,
31      retail_price: item.price.toFixed(2)    // For customs declarations
32    })),
33    retail_costs: {
34      currency: 'USD',
35      subtotal: cartItems.reduce((sum, i) => sum + i.price * i.quantity, 0).toFixed(2)
36    }
37  };
38
39  const resp = await printful.post('/orders', orderBody);
40  return resp.data.result;
41}
42
43// POST /api/checkout — called after successful payment
44app.post('/api/checkout', async (req, res) => {
45  const { customer, items, paymentIntentId } = req.body;
46  if (!paymentIntentId) {
47    return res.status(400).json({ error: 'Payment must be confirmed before creating order' });
48  }
49  try {
50    const order = await createPrintfulOrder(customer, items);
51    console.log(`Printful order created: ${order.id} (status: ${order.status})`);
52    res.json({
53      success: true,
54      printfulOrderId: order.id,
55      estimatedFulfillment: order.estimated_fulfillment_date
56    });
57  } catch (err) {
58    const detail = err.response?.data?.error?.message || err.message;
59    console.error('Order creation failed:', detail);
60    res.status(500).json({ error: 'Fulfillment submission failed', detail });
61  }
62});
63
64app.listen(3000, '0.0.0.0', () => console.log('Order server running on port 3000'));

1// webhooks.js — Receive Printful fulfillment webhooks in Express on Replit
2const express = require('express');
3const axios = require('axios');
4
5const printful = axios.create({
6  baseURL: 'https://api.printful.com',
7  headers: { 'Authorization': `Bearer ${process.env.PRINTFUL_API_KEY}` }
8});
9
10const app = express();
11app.use(express.json());
12
13// Register webhook URL with Printful (run once after deployment)
14async function registerWebhook(publicUrl) {
15  const resp = await printful.post('/webhooks', {
16    url: `${publicUrl}/webhooks/printful`,
17    types: ['package_shipped', 'order_failed', 'order_canceled']
18  });
19  console.log('Webhook registered:', resp.data.result);
20}
21
22// Webhook receiver
23app.post('/webhooks/printful', (req, res) => {
24  // Respond 200 immediately to prevent Printful retries
25  res.json({ received: true });
26
27  const { type, data } = req.body;
28  console.log(`Printful webhook: ${type}`, JSON.stringify(data, null, 2));
29
30  switch (type) {
31    case 'package_shipped':
32      const { order_id, tracking_number, tracking_url } = data.shipment || {};
33      console.log(`Order ${order_id} shipped. Tracking: ${tracking_number}`);
34      // TODO: update your DB, email customer with tracking_url
35      break;
36    case 'order_failed':
37      console.error(`Order ${data.order?.id} failed: ${data.reason}`);
38      // TODO: alert your team, refund customer if charged
39      break;
40    case 'order_canceled':
41      console.log(`Order ${data.order?.id} was canceled.`);
42      break;
43    default:
44      console.log(`Unhandled event type: ${type}`);
45  }
46});
47
48app.listen(3000, '0.0.0.0', () => {
49  console.log('Webhook server running on port 3000');
50  // Uncomment after deploying and getting your public URL:
51  // registerWebhook('https://your-app.your-username.repl.co');
52});