Built for the engineers who actually integrate it.
One coherent REST API surface covers checkout, tokenization, recurring billing, smart routing, payment recovery, and reporting. SDKs for Node, Python, PHP, and Go. Sandbox parity with production.
What you're actually working with
One API surface for every capability, built to behave the same way in production as it does in testing.
Signed webhooks
Every event is signed, so your systems can verify it really came from Centrobill.
- Signed events
- Verified sender
- Documented payloads
// Verify a webhook before trusting itconst expected = sign(rawBody, WEBHOOK_SECRET);if (!safeEqual(expected, req.headers[SIGNATURE_HEADER])) { return res.status(401).end(); // reject unsigned events}handleEvent(JSON.parse(rawBody));Idempotent writes
Retry any request safely. The same request never creates a second charge.
- Safe retries
- No duplicate charges
- Same response every time
POST /paymentsIdempotency-Key: 8c1f…42ab→ 201 Created { "status": "approved" }POST /payments // retry, same keyIdempotency-Key: 8c1f…42ab→ 200 OK { "status": "approved" } // no duplicateExponential backoff
Failed calls are retried with growing gaps, so a temporary issue doesn't become a lost payment.
- Spaced retries
- Automatic after a failure
- No retry storms
attempt 1 failed retry in 2sattempt 2 failed retry in 4sattempt 3 failed retry in 8sattempt 4 approvedSandbox mirrors production
What passes testing behaves the same way when it goes live.
- Test cards
- Simulated declines
- Same behaviour as live
// Same code, two environmentsconst client = createClient({ environment: "sandbox" });// Going live is a one-line changeconst client = createClient({ environment: "production" });
What's documented
Everything a real integration needs is already written down.
- Complete API reference with request and response examples in every supported language
- Webhook event types and payload structures
- A sandbox with test cards and simulated decline scenarios
- A status page with live uptime and incident history
Every setup starts with a conversation
Whatever stage you are at, from pre-launch to nine figures a year, bring your questions. Payments advice is free here.