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

  1. Sign up at console.orangepill.cloud
  2. Navigate to Settings → API Keys
  3. Create a test key (starts with sk_test_)
  4. 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