Environments

Test (sk_test_) and live (sk_live_): data, base URL and rules for each.

Clobepay has two separate environments. Each one is a different installation with its own database: a key, link or webhook from one environment never exists in the other.

API environments
TestLive
Key prefixsk_test_sk_live_
MoneyTest-environment fundsLive funds
livemode field in webhooksfalsetrue
DataTest-environment dataLive data from your business
RequirementsRegistered merchantVerified merchant authorized for production

Base URL

Every route lives under /api/v1. The test-environment base URL is https://api-staging.clobepay.com/api/v1. In production use the base URL of your account with an sk_live_ key. In the examples, $CLOBEPAY_API_BASE already includes /api/v1, so the same example works in both environments.

Rules

  • A key from the wrong environment returns 401 api_key_wrong_environment. The test environment never issues sk_live_ keys.
  • Never use real personal or card data in test.
  • Webhook endpoints are registered per environment: create one in each.