Ir al contenido
Documentación
Empieza gratis

Referencia REST

Timbro API 2026-10-01

Sección titulada «Timbro API 2026-10-01»

Referencia de pagos, facturas, configuración del negocio, reembolsos y webhooks.

Consultar OpenAPI

Operaciones

Sección titulada «Operaciones»

Pagos

Sección titulada «Pagos»
PUT
Asociar una factura aceptada a un pago/v1/payments/{paymentId}/invoice
POST
Crear la factura canónica para un pago capturado/v1/payments/{paymentId}/invoice
GET
Listar pagos/v1/payments
POST
Crear un pago/v1/payments
GET
Consultar un pago/v1/payments/{paymentId}
POST
Cancelar un pago/v1/payments/{paymentId}/cancel
PUT
Actualizar el destinatario de la factura de un pago/v1/payments/{paymentId}/invoice-recipient
PUT
Elegir el tipo de comprobante y el comprador/v1/payments/{paymentId}/invoice-choice

Suscripciones

Sección titulada «Suscripciones»
GET
Listar suscripciones mensuales/v1/subscriptions
POST
Crear una suscripción mensual con facturación fiscal automática/v1/subscriptions
GET
Consultar una suscripción y los pagos de sus períodos/v1/subscriptions/{subscriptionId}
GET
Consultar el historial de pagos de una suscripción/v1/subscriptions/{subscriptionId}/payments
POST
Cancelar los próximos pagos de una suscripción/v1/subscriptions/{subscriptionId}/cancel
POST
Crear un link de gestión para una suscripción/v1/subscriptions/{subscriptionId}/management
POST
Consultar el link para iniciar una suscripción/v1/subscriptions/{subscriptionId}/setup
POST
Reenviar el aviso de pago pendiente de una suscripción/v1/subscriptions/{subscriptionId}/recovery_notice

Facturación

Sección titulada «Facturación»
GET
Listar facturas/v1/invoices
POST
Crear una factura/v1/invoices
POST
Reemplazar una factura rechazada/v1/invoices/{invoiceId}/replacements
POST
Validar una factura sin emitirla/v1/invoices/preview
GET
Consultar una factura/v1/invoices/{invoiceId}
POST
Enviar una factura por correo al comprador/v1/invoices/{invoiceId}/deliveries
GET
Consultar la entrega de una factura/v1/invoices/{invoiceId}/deliveries/{deliveryId}
POST
Compartir una factura aceptada/v1/invoices/{invoiceId}/receipt-access
GET
Consultar una factura compartida/v1/invoice-receipts/{receiptId}
GET
Descargar el PDF de una factura compartida/v1/invoice-receipts/{receiptId}/pdf
GET
Descargar el XML firmado/v1/invoices/{invoiceId}/files/xml
GET
Descargar el PDF de la factura/v1/invoices/{invoiceId}/files/pdf

Reembolsos

Sección titulada «Reembolsos»
GET
Listar reembolsos/v1/refunds
POST
Crear un reembolso/v1/refunds
PUT
Asociar una nota de crédito aceptada a un reembolso/v1/refunds/{refundId}/invoice
GET
Consultar un reembolso/v1/refunds/{refundId}

Negocio

Sección titulada «Negocio»
GET
Consultar si el negocio puede emitir una factura de certificación/v1/business/certification/invoices/issuance-readiness
POST
Registrar una secuencia de certificación DGII/v1/business/certification/sequences
POST
Emitir una factura en certificación/v1/business/certification/invoices
GET
Consultar una factura de certificación/v1/business/certification/invoices/{invoiceId}
GET
Descargar el XML de una factura de certificación/v1/business/certification/invoices/{invoiceId}/xml
GET
Descargar el PDF de una factura de certificación/v1/business/certification/invoices/{invoiceId}/pdf
GET
Consultar el negocio/v1/business
PATCH
Actualizar el negocio/v1/business
GET
Consultar la autenticación de emisores del negocio/v1/business/certification/peer-authentication
POST
Activar o desactivar la autenticación de emisores/v1/business/certification/peer-authentication
GET
Consultar la certificación del negocio/v1/business/certification
POST
Preparar la certificación del negocio/v1/business/certification
POST
Informar un resultado de un paso de certificación DGII/v1/business/certification/evidence
POST
Declarar el paso DGII de la certificación del negocio/v1/business/certification/progress
GET
Consultar el archivo de pruebas de certificación/v1/business/certification/test-sets/current
POST
Guardar el archivo de pruebas de certificación/v1/business/certification/test-sets
POST
Ejecutar un archivo de pruebas de certificación/v1/business/certification/test-runs
GET
Consultar la última ejecución de pruebas de certificación/v1/business/certification/test-runs/current
GET
Descargar una factura de consumo que guardó una ejecución de pruebas/v1/business/certification/test-runs/{runId}/consumer-invoices/{eNcf}
POST
Firmar un documento del portal de certificación DGII/v1/business/certification/portal-documents/sign
POST
Configurar la facturación de un modo/v1/business/configure-invoicing
POST
Importar un certificado digital/v1/business/import-signing-certificate
POST
Registrar una secuencia de e-NCF/v1/business/record-sequence
POST
Emitir la factura de prueba/v1/business/issue-test-invoice
GET
Consultar la política de Checkout del comercio/v1/business/checkout-policy
PUT
Reemplazar la política de Checkout del comercio/v1/business/checkout-policy
POST
Verificar el RNC del negocio/v1/business/rnc-verification

Ajustes

Sección titulada «Ajustes»
GET
Listar documentos recibidos de suplidores/v1/received-documents
GET
Consultar un documento recibido de un suplidor/v1/received-documents/{receivedDocumentId}
POST
Aceptar o rechazar un documento recibido/v1/received-documents/{receivedDocumentId}/commercial-response
GET
Descargar el XML de un documento recibido/v1/received-documents/{receivedDocumentId}/files/xml
GET
Listar afiliaciones/v1/merchant-accounts
GET
Consultar una afiliación/v1/merchant-accounts/{merchantAccountId}
POST
Rotar la clave secreta que hace la llamada/v1/api-keys/rotate
GET
Consultar la tasa de cambio de referencia/v1/exchange-rates/{currency}

Webhooks

Sección titulada «Webhooks»
GET
Listar endpoints de webhook/v1/webhook-endpoints
POST
Crear un endpoint de webhook/v1/webhook-endpoints
GET
Consultar un endpoint de webhook/v1/webhook-endpoints/{webhookEndpointId}
DELETE
Eliminar un endpoint de webhook/v1/webhook-endpoints/{webhookEndpointId}
GET
Listar entregas de webhook/v1/webhook-endpoints/{webhookEndpointId}/deliveries
POST
Reenviar eventos de webhook/v1/webhook-endpoints/{webhookEndpointId}/replays
POST
Rotar el secreto del endpoint/v1/webhook-endpoints/{webhookEndpointId}/rotate-secret
POST
Suspender un endpoint de webhook/v1/webhook-endpoints/{webhookEndpointId}/suspend
POST
Reactivar un endpoint de webhook/v1/webhook-endpoints/{webhookEndpointId}/reactivate

Eventos

Sección titulada «Eventos»
POST
Webhook: subscription.canceled WEBHOOK
POST
Webhook: subscription.status_changed WEBHOOK
POST
Webhook: payment.succeeded WEBHOOK
POST
Webhook: payment.declined WEBHOOK
POST
Webhook: payment.canceled WEBHOOK
POST
Webhook: payment.expired WEBHOOK
POST
Webhook: payment.operator_required WEBHOOK
POST
Webhook: refund.succeeded WEBHOOK
POST
Webhook: refund.declined WEBHOOK
POST
Webhook: refund.operator_required WEBHOOK
POST
Webhook: refund.invoiceAttached WEBHOOK
POST
Webhook: invoice.accepted WEBHOOK
POST
Webhook: invoice.rejected WEBHOOK
POST
Webhook: invoice.operatorRequired WEBHOOK
POST
Webhook: invoice.ready WEBHOOK
POST
Webhook: invoice.deliverySent WEBHOOK
POST
Webhook: invoice.deliveryFailed WEBHOOK

Autenticación

Sección titulada «Autenticación»

secretKey

Sección titulada «secretKey»

Clave secreta. Solo para el servidor.

Tipo de esquema de seguridad: http

adminKey

Sección titulada «adminKey»

Clave de administrador. Solo para el servidor.

Tipo de esquema de seguridad: http

integrationToken

Sección titulada «integrationToken»

Token de acceso del cliente de máquina de una integración, como una empresa de Odoo, que se autentica con private_key_jwt. Pídelo con el recurso /v1 y los scopes de un solo modo; el token actúa solo en ese modo.

Tipo de esquema de seguridad: oauth2

Flow type: clientCredentials

Token URL: https://api.timbro.do/v1/merchant_auth/oauth2/token

Scopes:

  • invoices:test - Issue and read invoices, and read received documents in test mode.
  • invoices:live - Issue and read invoices, and read received documents in live mode.
  • payments:test - Create, read, and cancel payments and checkout tokens in test mode.
  • payments:live - Create, read, and cancel payments and checkout tokens in live mode.
  • refunds:test - Create and read refunds in test mode.
  • refunds:live - Create and read refunds in live mode.
  • sequences:live - Record the e-NCF sequences DGII granted the business in live mode.

invoiceReceiptAccess

Sección titulada «invoiceReceiptAccess»

Token de acceso de servidor para la factura compartida y el PDF de una factura aceptada. No permite emitir, consultar el XML ni acceder a diagnósticos.

Tipo de esquema de seguridad: http