Un cargo en feriado no es
solo un error. Es un chargeback.
El banco rechaza. El cliente llama furioso. El equipo de soporte pasa la tarde haciendo reversas. Todo por no saber que ese día era feriado en el país del cliente.
Menos chargebacks
Validar antes de cobrar elimina los cargos fallidos en feriado y la fricción que generan con el cliente.
Menos carga en soporte
Cada cobro en feriado genera tickets. Evitarlos desde el origen libera al equipo para lo que importa.
Reprogramación automática
Si el día no es hábil, el próximo día hábil está a un segundo endpoint de distancia.
Cómo funciona — para el equipo técnico
// ¿Es día hábil hoy en Chile?
GET api.feriados.io/v1/CL/is-business-day
?date=2026-09-18
{
"is_business_day": false,
"day_of_week": "Friday"
}
// → no cobrar, mover al próximo día hábil
GET api.feriados.io/v1/CL/business-days/add
?date=2026-09-18&days=1
{ "result_date": "2026-09-21" }Flujo completo para producción
// 1. Verificar si la fecha de cobro es hábil
const check = await fetch(
`https://api.feriados.io/v1/CO/is-business-day?date=${fecha}`,
{ headers: { "Authorization": `Bearer ${KEY}` } }
);
const { is_business_day } = (await check.json()).data;
if (!is_business_day) {
// 2. Mover al día hábil anterior (cobros bancarios)
const prev = await fetch(
`https://api.feriados.io/v1/CO/business-days/subtract?date=${fecha}&days=1`,
{ headers: { "Authorization": `Bearer ${KEY}` } }
);
const { result_date } = (await prev.json()).data;
fecha = result_date; // reprogramar al día hábil anterior
}
procesarDebito(fecha);¿Por qué no mantener la lista internamente?
Colombia tiene 20 feriados, pero 18 se mueven al lunes por Ley Emiliani. Argentina decreta puentes con menos de 2 semanas de anticipación. Un array hardcodeado en tu codebase deja de ser correcto antes de que termine el año. feriados.io actualiza los datos en menos de 24 horas de publicado cada decreto.
Plan Free — API key gratis
is-business-day es gratis para siempre
API key en 30 segundos, sin tarjeta. Para endpoints operativos, el plan Starter desde $9/mes.