Saltar al contenido principal
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

Billing requiere al menos el código Country ISO de dos letras. Use AttachExistingCustomer para adjuntar un cliente existente, o NewCustomer para crear uno. ProductPrice está en la denominación más baja de la moneda.

Manejo de Errores

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

Paginación

Paginación Automática

Itere a través de todos los resultados en todas las páginas utilizando el método Paginate, que devuelve un IAsyncEnumerable:

Paginación Manual

Integración con ASP.NET Core

Registre el cliente en su contenedor DI:
Program.cs
appsettings.json
Para el desarrollo, use secretos de usuario en lugar de almacenar claves en appsettings.json:

Recursos

NuGet Package

Ver paquete en NuGet Gallery

GitHub Repository

Ver código fuente y contribuir

API Reference

Documentación completa de la API

Discord Community

Obtenga ayuda y conéctese con desarrolladores

Soporte

¿Necesita ayuda con el SDK de C#?
Última modificación el 28 de mayo de 2026