Skip to main content
El SDK de C# proporciona acceso conveniente a la API REST de Dodo Payments desde aplicaciones escritas en C#. Presenta una API basada en Tareas asíncronas con tipado fuerte, reintentos automáticos y manejo integral de errores.

Instalación

Instala el paquete desde NuGet:
El SDK requiere .NET 8.0 o posterior. Funciona con ASP.NET Core, aplicaciones de consola y otros tipos de proyectos .NET.

Inicio Rápido

Inicializa el cliente y crea una sesión de pago:
Guarda siempre tus claves de API de forma segura usando variables de entorno, secretos de usuario o Azure Key Vault. Nunca las codifiques directamente en tu código fuente ni las comprometas al control de versiones.

Funcionalidades principales

Async/Await

API completa basada en Task asíncronos para operaciones no bloqueantes

Strong Typing

Seguridad de tipos exhaustiva con tipos de referencia anulables

Smart Retries

Reintentos automáticos con retroceso exponencial para errores transitorios

Error Handling

Jerarquía de excepciones incorporada para una gestión precisa de errores

Configuración

Variables de entorno

.env

Configuración Manual

Entornos

Cambia entre el modo en vivo y de prueba:

Reintentos

El SDK vuelve a intentar automáticamente 2 veces por defecto con retroceso exponencial. Reintenta en errores de conexión y códigos de estado 408, 409, 429 y 5xx.

Tiempos de Espera

Las solicitudes expiran después de 1 minuto por defecto.

Anulaciones Por Solicitud

Modifica temporalmente la configuración para una sola solicitud usando WithOptions:

Operaciones Comunes

Crear una Sesión de Pago

Gestionar Clientes

Manejar Suscripciones

El método POST /subscriptions del SDK (el método subscriptions.create) está obsoleto. Sigue funcionando para las integraciones existentes, pero las nuevas integraciones deben crear suscripciones mediante una Checkout Session.
Billing requiere como mínimo el código ISO de dos letras Country. Usa AttachExistingCustomer para asociar un customer existente, o NewCustomer para crear uno. ProductPrice está expresado en la denominación monetaria más baja.

Gestión de errores

El SDK lanza excepciones específicas según el código de estado HTTP. Todos los errores 4xx heredan de DodoPayments4xxException. Otros tipos de excepciones:
  • DodoPaymentsIOException: errores de red de E/S
  • DodoPaymentsInvalidDataException: error al interpretar los datos analizados
  • DodoPaymentsException: clase base para todas las excepciones

Paginación

Paginación automática

Recorre todos los resultados de todas las páginas mediante el método Paginate, que devuelve un IAsyncEnumerable:

Paginación manual

Integración con ASP.NET Core

Registra el cliente en tu contenedor de DI:
Program.cs
appsettings.json
Para el desarrollo, usa secretos de usuario en lugar de almacenar las claves en appsettings.json:

Recursos

NuGet Package

Ver el paquete en NuGet Gallery

GitHub Repository

Ver el código fuente y colaborar

API Reference

Documentación completa de la API

Discord Community

Obtén ayuda y conecta con desarrolladores

Soporte

¿Necesitas ayuda con el SDK de C#?
Última modificación el 17 de agosto de 2026