Developer documentation
Integrate Clobepay collections, payins, payouts, verification and webhooks from your server. Every guide is available in Spanish and English.
Get started
- QuickstartFrom a test key to your first payment link and its webhook, in five steps.
- EnvironmentsTest (sk_test_) and live (sk_live_): data, base URL and rules for each.
- API keys and authenticationSecret keys per merchant (MID) in Authorization: Bearer, scopes, rotation and revocation.
- IdempotencyRetry without duplicating payments or payouts using the Idempotency-Key header.
- ErrorsError response shape, stable codes and what to retry.
Integration
- Payment linksCreate a collection with a hosted payment page. It starts pending and is confirmed only when its payin is settled.
- Payins and depositsEvery incoming payment is a payin: statuses, the pending → settled rule and a deposit account per MID.
- PayoutsQuote and request payouts to beneficiaries and wallets; approval and dual signature.
- KYC and KYB via APIVerify the merchant via API: individual (KYC) or company (KYB), documents and liveness.
- WebhooksSigned notifications (Clobepay-Signature) with retries, secret rotation and resend.
Resources
API Reference
HTTP routes, parameters, responses, errors and examples in cURL, Node.js and Python, ready to use in your environment.