Commet
  • Precios
Iniciar SesiónRegistrarse
Introducción

Inicio rápido

Aprender

Gestionar ClientesPortal del Cliente

Recursos

Referencia del SDKVersionado de APIManejo de erroresTestingCLI

Plugins

Better Auth
DocumentaciónRecursosConstruir con AIAPI ReferenceWebhooks

Gestionar Clientes

Crea y gestiona clientes con el SDK de Commet y el dashboard.

Un cliente representa al negocio o persona a quien le cobras. Cada cliente puede tener una suscripción activa a la vez.

Dashboard

Navega a Clientes para ver, buscar y gestionar clientes. Desde la página de detalle de un cliente puedes asignar planes, ver detalles de suscripción y gestionar cobros.

Crear un cliente

const { data } = await commet.customers.create({
  email: 'billing@acme.com',
  id: 'user_123', // opcional — tu user ID para búsqueda fácil
})
// data.id → 'cus_abc123' (Commet ID)
response = commet.customers.create(
    email='billing@acme.com',
    id='user_123',  # opcional — tu user ID para búsqueda fácil
)
# response.data['id'] → 'cus_abc123' (Commet ID)
result, err := client.Customers.Create(ctx, &commet.CreateCustomerParams{
    Email: "billing@acme.com",
    ID:    "user_123", // opcional — tu user ID para búsqueda fácil
})
// result.Data.ID → "cus_abc123" (Commet ID)
CreateCustomerParams params = CreateCustomerParams.builder()
    .email("billing@acme.com")
    .id("user_123") // opcional — tu user ID para búsqueda fácil
    .build();
ApiResponse<Customer> result = commet.customers().create(params);
// result.getData().getId() → "cus_abc123" (Commet ID)
$result = $commet->customers->create(
    email: 'billing@acme.com',
    id: 'user_123', // opcional — tu user ID para búsqueda fácil
);
// $result->data['id'] → 'cus_abc123' (Commet ID)
curl -X POST https://commet.co/api/customers \
  -H "x-api-key: $COMMET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "billing@acme.com",
    "id": "user_123"
  }'

create es idempotente — si ya existe un cliente con el mismo id, devuelve el registro existente.

Parámetros

ParámetroTipoRequeridoDescripción
emailstringSíEmail de cobro
idstringNoTu user ID para búsqueda fácil
fullNamestringNoNombre del cliente
addressobjectNoDirección de cobro (line1, city, postalCode, country)
metadataobjectNoPares clave-valor custom

Crear clientes en batch

Crea hasta 100 clientes en un solo request. Cada cliente sigue las mismas reglas de idempotencia que la creación individual.

const { data } = await commet.customers.createBatch({
  customers: [
    { email: 'alice@acme.com', id: 'user_1' },
    { email: 'bob@acme.com', id: 'user_2' },
    { email: 'carol@acme.com', id: 'user_3' },
  ],
})
// data.successful, data.failed
response = commet.customers.create_batch([
    {'email': 'alice@acme.com', 'id': 'user_1'},
    {'email': 'bob@acme.com', 'id': 'user_2'},
    {'email': 'carol@acme.com', 'id': 'user_3'},
])
result, err := client.Customers.CreateBatch(ctx, []commet.CreateCustomerParams{
    {Email: "alice@acme.com", ID: "user_1"},
    {Email: "bob@acme.com", ID: "user_2"},
    {Email: "carol@acme.com", ID: "user_3"},
}, "")
ApiResponse<BatchResult> result = commet.customers().createBatch(List.of(
    Map.of("email", "alice@acme.com", "external_id", "user_1"),
    Map.of("email", "bob@acme.com", "external_id", "user_2"),
    Map.of("email", "carol@acme.com", "external_id", "user_3")
));
$result = $commet->customers->createBatch([
    ['email' => 'alice@acme.com', 'id' => 'user_1'],
    ['email' => 'bob@acme.com', 'id' => 'user_2'],
    ['email' => 'carol@acme.com', 'id' => 'user_3'],
]);
curl -X POST https://commet.co/api/customers/batch \
  -H "x-api-key: $COMMET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customers": [
      { "email": "alice@acme.com", "id": "user_1" },
      { "email": "bob@acme.com", "id": "user_2" },
      { "email": "carol@acme.com", "id": "user_3" }
    ]
  }'

La respuesta incluye arrays successful y failed para manejar fallos parciales.

Obtener un cliente

const { data } = await commet.customers.get({ id: 'cus_abc123' })
response = commet.customers.get(customer_id='cus_abc123')
result, err := client.Customers.Get(ctx, "cus_abc123")
ApiResponse<Customer> result = commet.customers().get("cus_abc123");
$result = $commet->customers->get('cus_abc123');
curl https://commet.co/api/customers/cus_abc123 \
  -H "x-api-key: $COMMET_API_KEY"

Actualizar un cliente

await commet.customers.update({
  customerId: 'cus_abc123',
  email: 'new@acme.com',
  address: { line1: '123 Main St', city: 'Austin', postalCode: '78701', country: 'US' },
})
commet.customers.update(
    customer_id='cus_abc123',
    email='new@acme.com',
    address={'line1': '123 Main St', 'city': 'Austin', 'postal_code': '78701', 'country': 'US'},
)
client.Customers.Update(ctx, "cus_abc123", &commet.UpdateCustomerParams{
    Email: "new@acme.com",
    Address: &commet.Address{
        Line1:      "123 Main St",
        City:       "Austin",
        PostalCode: "78701",
        Country:    "US",
    },
})
UpdateCustomerParams params = UpdateCustomerParams.builder()
    .email("new@acme.com")
    .address(Address.builder()
        .line1("123 Main St")
        .city("Austin")
        .postalCode("78701")
        .country("US")
        .build())
    .build();
commet.customers().update("cus_abc123", params);
$commet->customers->update(
    customerId: 'cus_abc123',
    email: 'new@acme.com',
    address: [
        'line1' => '123 Main St',
        'city' => 'Austin',
        'postalCode' => '78701',
        'country' => 'US',
    ],
);
curl -X PUT https://commet.co/api/customers/cus_abc123 \
  -H "x-api-key: $COMMET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "new@acme.com",
    "address": {
      "line1": "123 Main St",
      "city": "Austin",
      "postalCode": "78701",
      "country": "US"
    }
  }'

Parámetros

ParámetroTipoRequeridoDescripción
customerIdstringSíID de Commet (cus_xxx) o tu user ID
emailstringNoNuevo email de cobro
fullNamestringNoNombre del cliente
timezonestringNoZona horaria IANA
metadataobjectNoPares clave-valor custom
addressobjectNoDirección de cobro (line1, line2, city, state, postalCode, country)

Listar clientes

Paginación basada en cursor. Devuelve hasta 100 clientes por página.

const { data, hasMore, nextCursor } = await commet.customers.list({ limit: 25 })
response = commet.customers.list(limit=25)
# response.data, response.has_more, response.next_cursor
result, err := client.Customers.List(ctx, &commet.ListCustomersParams{
    Limit: 25,
})
// result.Data, result.HasMore, result.NextCursor
ApiResponse<List<Customer>> result = commet.customers().list(null, null, 25, null);
// result.getData(), result.isHasMore(), result.getNextCursor()
$result = $commet->customers->list(limit: 25);
// $result->data, $result->hasMore, $result->nextCursor
curl "https://commet.co/api/customers?limit=25" \
  -H "x-api-key: $COMMET_API_KEY"

Para obtener la siguiente página, pasa el valor de nextCursor.

const nextPage = await commet.customers.list({
  limit: 25,
  cursor: nextCursor,
})
next_page = commet.customers.list(
    limit=25,
    cursor=next_cursor,
)
nextPage, err := client.Customers.List(ctx, &commet.ListCustomersParams{
    Limit:  25,
    Cursor: nextCursor,
})
ApiResponse<List<Customer>> nextPage = commet.customers().list(null, null, 25, nextCursor);
$nextPage = $commet->customers->list(
    limit: 25,
    cursor: $nextCursor,
);
curl "https://commet.co/api/customers?limit=25&cursor=$NEXT_CURSOR" \
  -H "x-api-key: $COMMET_API_KEY"

Relacionado

  • Portal del Cliente
  • Gestionar Suscripciones

¿Cómo está esta guía?

Integrar con Symfony

Agrega cobros y pagos a tu aplicación de Symfony.

Portal del Cliente

Portal de autoservicio para que tus clientes gestionen sus suscripciones.

En esta página

Dashboard
Crear un cliente
Parámetros
Crear clientes en batch
Obtener un cliente
Actualizar un cliente
Parámetros
Listar clientes
Relacionado