Titanio PayCEOO Tecnologías DocsEntrar al panel
Núcleo 2.0.016 oct 2026Escrito en V++

Cobras a tu nombre.
Titanio lleva la cuenta.

Fichas SPEI con referencia única, conciliación contra tu estado de cuenta y el CEP de Banxico, cuotas mensuales con descuento y recargo, webhooks firmados y un libro mayor que no se puede alterar sin que se note. El dinero llega directo a tu cuenta: Titanio registra, concilia y avisa.

Libro mayorconsultando…
Asientos—
Cadena—
Cifras en vivo · los tres asientos son un ejemplo de formato
01 · El principio

El dinero nunca pasa por Titanio. Por eso puede cuidarlo.

EL COMERCIO

Cobra a su propia cuenta

Cada fraccionamiento o negocio tiene su CLABE. Sin CLABE propia, Titanio no emite la ficha.

TITANIO

Registra y concilia

Referencia de 7 dígitos con verificador, conciliación por estado de cuenta y por CEP de Banxico, comisión de plataforma asentada.

TU SISTEMA

Se entera firmado

Webhook con HMAC-SHA256, marca de tiempo e id único por evento. Reintentos durante 38 horas.

02 · Capacidades del núcleo

Lo que hace, y lo que prueba.

Cada capacidad tiene pruebas automáticas que se corren contra una instancia aislada antes de publicar.

97 pruebas · 0 fallas · 16 oct 2026
  1. Idempotencia de verdad

    Cada cobro exige Idempotency-Key. Doce peticiones simultáneas con la misma llave crean un solo cobro; la misma llave con otro cuerpo responde 409.

  2. Máquina de estados sin atajos

    Creado, pendiente, pagado, fallido, expirado, reembolsado. Una transición fuera de la tabla se rechaza y queda en la bitácora de seguridad; la misma noticia dos veces no hace nada la segunda.

  3. Libro mayor encadenado

    Solo crece. Cada asiento lleva el sha256 del anterior: cambiar un monto, borrar o reordenar se detecta y se señala el asiento exacto. Los pagos se sellan además en BlockCEOO.

  4. Montos en centavos enteros

    Ni un flotante toca el dinero. La comisión de plataforma (puntos base más fija) se calcula al centavo y se asienta aparte.

  5. Multi-comercio con aislamiento

    Una plataforma administra a sus comercios hijos (un fraccionamiento, un vendedor). Ninguno ve lo de otro, ni siquiera para saber si existe.

  6. SPEI por referencia y conciliación

    Ficha para quien paga, importación del estado de cuenta en CSV, consulta del CEP de Banxico. Cada abono se aplica una vez; lo que no cuadra va a excepciones, nunca a la basura.

  7. Cuotas recurrentes

    Planes con día de vencimiento, descuento por pronto pago y recargo por atraso. Un cobro por periodo, aunque el proceso corra dos veces, y avisos en cola para que nadie reciba cien correos por error.

  8. Seguridad por defecto

    Límites por IP y por comercio, llaves guardadas solo como hash, secretos fuera del código, notificaciones de proveedores autenticadas por firma con protección contra repetición.

03 · Ciclo de vida de un cobro

Seis estados. Ninguna puerta trasera.

Un cobro SPEI no se declara pagado a mano: se concilia. Un pagado no vuelve a pendiente. Un reembolso solo existe después de un pago.

Transiciones permitidas: creado a pendiente, fallido, expirado o pagado; pendiente a pagado, fallido o expirado; pagado a reembolsado. creado pendiente pagado fallido · expirado reembolsado ficha emitida conciliado · CEP cancelado · venció reembolso solo método «registro», con evidencia
409 transición ilegal200 · sin_cambio noticia repetidabitácora cada intento fuera de regla
04 · Métodos de pago

Estado real, sin adornos.

Lo activo funciona hoy. Lo que dice «requiere contrato» necesita un agregador o un banco, y un KYB a nombre de quien cobra. Esta tabla se lee en vivo de la API.

SPEI con referencia

activo

Titanio directo: referencia única, conciliación por estado de cuenta del comercio y verificación por CEP de Banxico.

Requiere: CLABE propia del comercio.

Registro de cobros por fuera

activo

Caja, depósito: se registran con evidencia obligatoria.

Tarjeta y OXXO (ventas de CEOO)

activo solo CEOO

Adquirente ya contratado por CEOO para sus ventas propias. No se usa para cobrar a nombre de terceros.

Tarjeta para terceros

requiere contrato

Vía agregador, checkout alojado por el proveedor (PCI SAQ A) y cargo directo a la cuenta del comercio.

Efectivo en tiendas

requiere contrato

OXXO, Paynet: vía agregador con KYB del comercio.

CoDi y DiMo

requiere banco

Banco participante del comercio. En homologación por Banxico hasta diciembre de 2026.

Domiciliación

requiere banco

Contrato bancario del comercio y mandato firmado por cada cliente.

Cripto (USDC, Polygon)

no recomendado

La verificación en cadena existe, pero no se habilita sin opinión fiscal y de prevención de lavado.

Comisiones, tiempos de acreditación y requisitos de cada método, con sus fuentes: matriz de métodos de pago · riesgos regulatorios.

05 · Para integradores

Una API que no te deja equivocarte.

  • Llave por comercio y, para plataformas, la cabecera Titanio-Comercio.
  • Idempotencia obligatoria en cada cobro.
  • Webhooks firmados: verifica la firma, la marca de tiempo y el id; relee el cobro antes de entregar.
  • Compatibilidad: las rutas de la versión anterior siguen idénticas.
Crear un cobro SPEI
curl https://ceoo.world/pago/api/v1/cobros \
  -H "Authorization: Bearer tp_fracc-lomas_…" \
  -H "Idempotency-Key: prv-8841-1" \
  -d '{"monto_centavos": 250000,
       "concepto": "Cuota octubre · Casa 14",
       "referencia_externa": "PRV-12-8841"}'

# 201 → estado "pendiente", referencia_spei "6860411",
#       instrucciones_url con la ficha para quien paga
Lo que llega a tu webhook
POST /tu/webhook
Titanio-Firma: t=1792180296,v1=5c0e…
X-Titanio-Evento: evt_8b1d…
Titanio-Evento: cobro.pagado

# v1 = HMAC-SHA256(secreto, t + "." + cuerpo)
# rechaza si |ahora − t| > 300 s o si ya viste el id
06 · Novedades

Lo que cambió, con fecha.

  1. v2.0.016 de octubre de 2026

    Núcleo propio en V++

    • Cobros con id único, idempotencia y máquina de estados de seis estados.
    • Libro mayor encadenado con verificación de integridad y comisión de plataforma asentada.
    • Multi-comercio: plataformas con comercios hijos aislados.
    • SPEI por referencia con conciliación por estado de cuenta y consulta del CEP de Banxico.
    • Cuotas recurrentes con descuento, recargo y avisos en cola.
    • Webhooks firmados con reintentos durante 38 horas y bitácora.
    • Proveedor sandbox para probar integraciones sin mover dinero.
    • Rutas anteriores intactas; cada cobro anterior queda reflejado en el libro mayor.
  2. riel cripto4 de septiembre de 2026

    Verificación en cadena sin nodo propio

    • Lectura de pagos USDC en Polygon con ventana corta y nodos públicos en cascada. Hoy en pausa por criterio regulatorio.
  3. origen7 de julio de 2026

    Primera versión

    • Enlaces de pago con tarjeta y OXXO, panel de transacciones y sello en BlockCEOO.

Qué es Titanio Pay, y qué no.

Titanio Pay es software de cobranza de CEOO Tecnologías. No es banco, ni institución de fondos de pago electrónico, ni agregador: no abre cuentas, no guarda saldos y no recibe ni reparte dinero de terceros.

Los pagos con tarjeta o en tiendas los procesa el agregador o el banco que cada comercio contrate. Titanio nunca ve datos de tarjeta.