Integration Guides

In your CertNode dashboard, navigate to Integrations → Stripe and click Connect with Stripe. This uses OAuth to securely connect your Stripe account.

CertNode automatically registers a webhook endpoint with Stripe. No manual configuration needed.

Create a test payment in Stripe (using test mode) and verify that a receipt appears in your CertNode dashboard.

Advanced: Custom Receipt Data

Add custom metadata to your Stripe payments to include additional data in receipts:

// When creating Stripe payment
const paymentIntent = await stripe.paymentIntents.create({
  amount: 29999,
  currency: 'usd',
  metadata: {
    certnode_product_name: 'Annual Subscription',
    certnode_subscription_id: 'sub_123',
    certnode_customer_tier: 'premium'
  }
})

// CertNode automatically includes metadata in receipt

Visit the Shopify App Listing and click Install App. Approve the requested permissions.

Choose which Shopify events should create receipts:

Create a test order in Shopify and verify receipt creation:

Determine where in your application you want to create receipts:

Create a reusable function to create receipts:

// lib/certnode.ts
import crypto from 'crypto'

export async function createReceipt(params: {
  type: 'transaction' | 'content' | 'operations'
  data: Record<string, any>
  metadata?: Record<string, any>
  parentId?: string
}) {
  // Hash any PII before sending
  const sanitizedData = {
    ...params.data,
    customer_email_hash: params.data.customer_email
      ? crypto.createHash('sha256').update(params.data.customer_email).digest('hex')
      : undefined,
  }
  delete sanitizedData.customer_email // Remove raw email

  const response = await fetch('https://certnode.io/api/v1/receipts', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.CERTNODE_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      type: params.type,
      data: sanitizedData,
      metadata: params.metadata,
      parent_id: params.parentId,
    }),
  })

  if (!response.ok) {
    throw new Error(`Failed to create receipt: ${response.statusText}`)
  }

  return response.json()
}

Use the helper function where needed:

// Example: After processing payment
async function processPayment(orderId: string) {
  // 1. Process payment with your payment processor
  const payment = await paymentProcessor.charge(...)

  // 2. Create CertNode receipt
  const receipt = await createReceipt({
    type: 'transaction',
    data: {
      amount: payment.amount,
      currency: payment.currency,
      product: payment.product_name,
      customer_email: payment.customer_email, // Will be hashed
      order_id: orderId,
    },
    metadata: {
      platform: 'custom_app',
      payment_processor: 'stripe',
      environment: process.env.NODE_ENV,
    },
  })

  // 3. Store receipt ID for later reference
  await db.orders.update(orderId, {
    certnode_receipt_id: receipt.id,
    certnode_verification_url: receipt.verification_url,
  })

  // 4. (Optional) Send verification URL to customer
  await sendEmail(payment.customer_email, {
    subject: 'Receipt for your purchase',
    body: `Your cryptographic receipt: ${receipt.verification_url}`,
  })

  return receipt
}

Link related receipts together:

// Example: Order → Fulfillment → Delivery chain
async function fulfillOrder(orderId: string) {
  const order = await db.orders.findById(orderId)

  // Create fulfillment receipt linked to order receipt
  const fulfillmentReceipt = await createReceipt({
    type: 'operations',
    data: {
      event: 'order_fulfilled',
      order_id: orderId,
      tracking_number: '1Z999AA10123456784',
      shipped_date: new Date().toISOString(),
    },
    metadata: {
      platform: 'custom_app',
    },
    parentId: order.certnode_receipt_id, // Link to order receipt
  })

  return fulfillmentReceipt
}