Prevalidación de pagos

​

Incluir un objeto sender_account

{
  "amount": 1000,
  "currency": "clp",
  "metadata": {
    "order": "#987654321"
  },
  "customer_email": "customer@example.com",
  "sender_account": {
    "holder_id": "195669317",
    "institution_id": "cl_banco_estado"
  }
}

• holder_id: el RUT (Rol Único Tributario) del titular de la cuenta
• institution_id: el ID de la institución bancaria.

• Si solo envías el holder_id sin institution_id, Fintoc usará límites generales para nuevos contactos, permitiendo que pasen más pagos sin cancelar incorrectamente.
• Si solo envías el institution_id sin holder_id, Fintoc solo validará los límites específicos del banco para montos máximos y mínimos de transferencia.
• Si envías ambos, Fintoc realizará todas las validaciones para el payment intent.

​

Proceso de validación

1. Límites específicos del banco: verificamos si el monto del pago está dentro de los límites permitidos para el banco especificado. Para activar esta validación, envía el institution_id.
2. Límites para nuevos contactos: para transferencias por primera vez o transferencias dentro de las 24 horas de la primera transferencia, las instituciones aplican límites más estrictos. Para Pagos Directos, esta validación ocurrirá mirando los pagos previos del mismo usuario. Si tus usuarios han pagado fuera del flujo de pago de Fintoc, recomendamos no activar esta funcionalidad. Para activar esta validación, envía el holder_id y institution_id.
3. Montos máximos de transferencia: nos aseguramos de que el pago no exceda el monto máximo permitido de transferencia para el banco especificado. Para activar esta validación, envía el holder_id.

​

Respuestas de error

1. Error de límite máximo de monto para nuevo contacto: Fintoc primero verifica si el holder_id ha hecho un pago antes y cuándo. Si no, luego verifica si el monto excede el límite de la institución.

{
  "error": {
    "type": "new_contact_error",
    "message": "The amount exceeds the maximum amount permitted for new contacts. For this institution, the maximum permissible amount is $[amount]. This restriction ends at [timestamp]",
    "code": "new_contact_maximum_amount_limit_error"
  }
}

2. Error de límite de número de pagos para nuevo contacto: Fintoc primero verifica si el holder_id ha hecho su primer pago durante el mismo día. Si lo ha hecho, luego verifica si la institución permite más de una transferencia a un nuevo contacto.

{
  "error": {
    "type": "new_contact_error",
    "message": "The maximum number of transfers for new contacts was reached. This restriction ends at [timestamp]",
    "code": "new_contact_payment_number_limit_error"
  }
}

3. Error de límite mínimo de monto: Fintoc verifica si el monto es menor al mínimo permitido por la institución.

{
  "error": {
    "type": "amount_limit_error",
    "message": "The amount is lower than the minimum amount permitted for payments by the institution. Please enter an amount greater than $[amount].",
    "code": "minimum_amount_limit_error"
  }
}

4. Error de límite máximo de monto: Fintoc verifica si el monto es menor al mínimo permitido por la institución.

{
  "error": {
    "type": "amount_limit_error",
    "message": "The amount exceeds the maximum amount permitted for payments by the institution. Please enter an amount less than $[amount].",
    "code": "maximum_amount_limit_error"
  }
}

​

Mejores prácticas

1. Siempre incluye la información de sender_account al crear un payment intent para asegurar las validaciones más precisas.
2. Maneja las respuestas de error de forma elegante en tu aplicación, proporcionando retroalimentación clara a tus usuarios sobre por qué un pago no pudo ser procesado.
3. Haz ajustes a tu orden para que los usuarios puedan pagar. Estos podrían ser cambiar el monto del pago si es posible o configurar recordatorios para pagos futuros.