Paystack

Paystack notifies your server when a payment succeeds. Forward that event to Taifa Mail and a branded receipt goes out automatically.

Use cases

• Email a receipt automatically on every successful charge.
• Notify your finance team when a subscription renews or fails.
• Trigger a thank-you sequence after a first payment.

How it works

Paystack charge.success  ->  your server  ->  Taifa Mail /v1/emails/  ->  receipt to customer

Step 1: Add a Paystack webhook

In your Paystack dashboard, go to Settings -> API Keys & Webhooks and set the webhook URL to an endpoint on your server. Verify the x-paystack-signature header before trusting the event.

Step 2: Send on charge.success

When a charge.success event arrives, call the Taifa Mail API with the customer's details.

// inside your Paystack webhook handler, after signature verification
if (event.event === 'charge.success') {
  await taifamail.emails.send({
    from: 'receipts@yourbusiness.co.ke',
    to: event.data.customer.email,
    subject: `Receipt for ${event.data.reference}`,
    html: receiptHtml(event.data) // amount, reference, date
  });
}

Step 3: Reuse a template

Keep the receipt as an Taifa Mail template so finance can edit the copy without touching code.

Native integration coming soon

A no-code Paystack recipe that maps events to templates without a server is on the roadmap.

Next steps

• REST API
• Templates