WhatsApp Commerce 5 min read

Launch WhatsApp Checkout in 15 Minutes

Turn WhatsApp conversations into transactions. Customers pay without leaving the chat.

Problem

  • WhatsApp sales are manual (copy-paste payment links, confirm manually)
  • Customers drop off when redirected to external checkout
  • Tracking orders across WhatsApp threads is chaos
  • No way to send automated confirmations

What You’ll Build

  • WhatsApp catalog with products
  • One-click checkout links
  • Automatic payment confirmations
  • Order status updates in chat

Architecture

WhatsApp → Orangepill Checkout → Payment → Confirmation → WhatsApp

Customer stays in WhatsApp the entire time. No app switching.

Steps

1. Connect WhatsApp Business

Sign up at console.orangepill.cloud:

  • Navigate to Channels → WhatsApp
  • Click “Connect WhatsApp Business”
  • Verify your phone number
  • Approve message templates

2. Upload Product Catalog

Add products via dashboard or API:

const product = await orangepill.products.create({
  name: "Wireless Headphones",
  price: 150000,
  currency: "COP",
  image: "https://example.com/headphones.jpg",
  description: "Noise cancelling, 30hr battery"
});

3. Create Checkout Session

When customer asks to buy:

const session = await orangepill.whatsapp.checkout.create({
  phone: "+573001234567",
  items: [
    { product_id: "prod_abc123", quantity: 1 }
  ],
  payment_methods: ["bre_b", "nequi", "card"]
});

// Send checkout link
await orangepill.whatsapp.messages.send({
  to: "+573001234567",
  type: "text",
  text: {
    body: `¡Tu pedido está listo! Paga aquí: ${session.url}`
  }
});

4. Customer Pays

Customer clicks link → sees checkout → pays with Bre-B/Nequi/card → done.

All happens inside WhatsApp browser. No app download.

5. Automatic Confirmation

When payment succeeds, Orangepill sends confirmation automatically:

✅ Pago recibido!

Pedido #12345
Total: $150.000 COP
Método: Bre-B

Envío estimado: 2-3 días

6. Handle Webhooks

Listen for payment events:

app.post('/webhooks/orangepill', (req, res) => {
  const event = req.body;

  if (event.type === 'payment.succeeded') {
    const order = event.data;

    // Fulfill order
    fulfillOrder(order.metadata.order_id);

    // Send tracking link via WhatsApp
    sendTrackingLink(order.customer.phone, order.id);
  }

  res.sendStatus(200);
});

7. Test End-to-End

Use sandbox mode:

  • Test phone number: your WhatsApp
  • Test products: any catalog items
  • Test payment: use test Bre-B credentials
  • Verify confirmation message arrives

Code Sample

Full checkout flow:

// When customer sends "I want to buy X"
async function handlePurchaseIntent(phone, productName) {
  // Find product
  const product = await findProduct(productName);

  // Create checkout
  const session = await orangepill.whatsapp.checkout.create({
    phone,
    items: [{ product_id: product.id, quantity: 1 }],
    metadata: { source: "whatsapp_chat" }
  });

  // Send link
  await orangepill.whatsapp.messages.send({
    to: phone,
    type: "text",
    text: { body: `Paga aquí: ${session.url}` }
  });
}

Outcome

WhatsApp conversations convert to orders automatically. No manual payment confirmation. Customers never leave the chat.

Typical results:

  • 60% higher conversion vs external checkout
  • 10x faster order processing
  • 90% reduction in payment support messages

What to read next