all
3 min read
Delivery Automation
Digital delivery on Sokobuni is fully automatic. You don't need to manually send files to customers — the platform handles it the moment payment is confirmed.
The delivery flow
Customer pays → Order confirmed → Delivery email triggered → Customer downloads
Here's the exact sequence:
1
Customer completes checkout
After entering their details and selecting a payment method (PesaPal, card, etc.), they confirm the order.
2
Payment is confirmed
PesaPal or the card processor sends a webhook to Sokobuni confirming the payment succeeded. This happens in seconds.
3
Digital fulfillment triggers automatically
The platform detects the order contains a digital product and fires the digital-product-fulfillment workflow.
4
Download URL is generated
A secure, signed S3 URL is created with a 5-minute expiry. This URL is unique to this customer and order.
5
Email is sent via SendGrid
The customer receives a branded email with a "Download Now" button. The email is sent within 30–60 seconds of payment.
6
Customer account is updated
The file appears in the customer's account under "Digital Products", where they can generate a fresh download link at any time (within their download limit).
What the customer sees
The delivery email contains:
- Your store name and logo
- The product name
- A "Download Now" button (valid for 5 minutes)
- A note explaining they can return to their account for future downloads
🖼️
Screenshot: Digital product delivery email with download button
Handling failed payments
If a payment fails (card declined, PesaPal timeout), the digital delivery email is not sent. The order remains in "Pending" status. The customer can retry payment from their account.
Re-sending a delivery email
If a customer claims they didn't receive the email:
- Go to Orders and find their order
- Open the order detail
- Look for Digital Fulfillments and click Resend email
🔥Important
Always check the spam folder first — SendGrid delivery emails occasionally land there depending on the customer's email provider.
Testing delivery
To test digital delivery before going live:
- Create a test product with a small file
- Place a test order using your own email
- Complete payment via PesaPal test mode
- Confirm you receive the delivery email within 60 seconds