SDKs oficiais

Três pacotes oficiais no servidor: TypeScript, PHP e Python. O mesmo contrato /v1, a mesma idempotência e o mesmo webhook no body cru.

Escolha a linguagem

A chave fica no servidor: cb_test_ no sandbox, cb_live_ na cobrança real. Valores em centavos. Todo POST leva Idempotency-Key. Confira a assinatura do webhook no body cru, antes do JSON.

TypeScriptnpm install cobrebaseNode.js 20+. constructEvent, listAll, testHelpers e testClocks.Abrir o guia
PHPcomposer require cobrebase/cobrebasePHP 8.2+. Webhook::constructEvent, all() e testClocks.Abrir o guia
Pythonpip install cobrebasePython 3.11+. construct_event, list_all e test_clocks.Abrir o guia

Contrato HTTP campo a campo: referência da API.

Exemplos

Cliente, assinatura, PIX, checkout e webhook nas três linguagens. O passo a passo completo está em cada guia.

npm install cobrebase

billing.ts

Cria o cliente e liga a um preço que já existe. A Cobre Base emite a fatura do ciclo.

import { CobreBase } from "cobrebase";

const cb = new CobreBase(process.env.COBREBASE_API_KEY!);

const customer = await cb.customers.create(
  { name: "Acme Tecnologia", email: "[email protected]" },
  { idempotencyKey: "customer-acme-42" },
);

const subscription = await cb.subscriptions.create(
  {
    customer_id: customer.id,
    items: [{ price_id: "price_...", quantity: 1 }],
  },
  { idempotencyKey: "sub-acme-42" },
);