Getting Started
Build commerce experiences with payments, wallets, and automation. Get your API key and make your first request in under 5 minutes.
What you’ll build
- Authenticate with API keys
- Make your first API request
- Receive webhook events
- Test in sandbox mode
Quick example
curl https://api.orangepill.cloud/v1/payment-requests \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"amount": 50000,
"currency": "COP",
"payment_method_types": ["bre_b", "card"],
"success_url": "https://example.com/success",
"cancel_url": "https://example.com/cancel"
}'
Get your API key
- Sign up at console.orangepill.cloud
- Navigate to Settings → API Keys
- Create a test key (starts with
sk_test_) - Use sandbox mode for development
Webhook setup
Receive real-time events for payments, wallets, and customer actions:
curl https://api.orangepill.cloud/v1/webhooks \
-H "Authorization: Bearer sk_test_..." \
-d '{
"url": "https://example.com/webhooks",
"events": ["payment.succeeded", "payment.failed"]
}'
Supported environments
- Sandbox: Test with fake payment methods
- Production: Live transactions with real money
Next steps
- Ecommerce Quickstart - Connect WooCommerce/Shopify
- WhatsApp Quickstart - Build conversational checkout
- Bre-B Quickstart - Accept instant payments in Colombia
- Webhooks - Listen to real-time events
- SDKs - Official client libraries