Connect WooCommerce to Local Payments in Latin America
Accept Bre-B, PSE, Nequi, cards, and WhatsApp payments without custom code.
Problem
- Customers abandon checkout when their preferred payment method isn’t available
- International payment providers have low approval rates in LATAM
- Manual WhatsApp sales don’t scale
- Payment failures cost you revenue
What You’ll Build
- WooCommerce store with LATAM payment methods
- Bre-B, PSE, Nequi, cards, wallets
- WhatsApp checkout links
- Automatic retry and failover
Architecture
WooCommerce → Orangepill → Local Payment Methods → WhatsApp
Your store stays the same. Orangepill handles routing, retries, and regional payment methods.
Steps
1. Install Orangepill Plugin
In your WordPress admin:
- Go to Plugins → Add New
- Search “Orangepill Payments”
- Click Install Now → Activate
2. Configure API Keys
Navigate to WooCommerce → Settings → Payments → Orangepill:
API Key: sk_live_...
Webhook Secret: whsec_...
Get keys from console.orangepill.cloud
3. Enable Payment Methods
Select payment methods for your target countries:
Colombia:
- Bre-B (instant bank transfers, 24/7)
- PSE (bank transfers)
- Nequi, Daviplata (wallets)
- Credit/debit cards
Mexico:
- SPEI transfers
- OXXO cash
- Cards
Brazil:
- Pix
- Boleto
- Cards
4. Enable WhatsApp Checkout (Optional)
Turn on WhatsApp integration:
- Enable “WhatsApp Checkout Links”
- Connect WhatsApp Business number
- Customers get payment links via WhatsApp
5. Test in Sandbox
Use test mode to verify:
# Test API key (safe, no real money)
sk_test_abcd1234...
# Simulate Bre-B payment
Test Bank: Any bank
Status: Success
6. Configure Retries & Fallbacks
Enable smart routing:
- Primary: Bre-B
- Fallback: PSE
- Final: Cards
Orangepill automatically retries failed payments with alternative methods.
7. Go Live
Switch to production:
- Replace
sk_test_withsk_live_key - Disable test mode
- Monitor payments in dashboard
Code Sample
No code required! But if you want custom checkout behavior:
// Add custom payment metadata
add_filter('orangepill_payment_metadata', function($metadata, $order) {
$metadata['customer_segment'] = get_user_meta(
$order->get_customer_id(),
'segment',
true
);
return $metadata;
}, 10, 2);
Outcome
Customers pay with their preferred method. Failed payments automatically retry. WhatsApp orders convert without manual work.
Typical results:
- 15-25% higher approval rates
- 40% reduction in payment support tickets
- 3x faster WhatsApp order processing
What to read next
Reduce failed payments
Routing, retries, and fallbacks for higher approval rates.
Launch WhatsApp checkout
Add conversational checkout inside your existing storefront.
Grow ecommerce
How to grow conversion on WooCommerce, Shopify, and VTEX in LATAM.
Payments API
Reference for the methods, webhooks, and metadata used in this guide.