Ecommerce 6 min read

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_ with sk_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