Verificación de elegibilidad del pago

• Usar el endpoint payment_intents/check_eligibility para verificar la elegibilidad antes de mostrarle al usuario los métodos de pago aceptados.
• Incluir un objeto sender_account al crear una Checkout Session o un Payment Intent para verificar cuando el usuario selecciona Fintoc como método de pago.

​

Uso del endpoint payment_intents/check_eligibility

curl --request POST \
     --url https://api.fintoc.com/v1/payment_intents/check_eligibility \
     --header 'Authorization: sk_test_9c8d8CeyBTx1VcJzuDgpm4H' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "amount": 1000,
  "currency": "clp",
  "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 institution_id y no el holder_id, Fintoc solo validará los límites específicos del banco para los montos máximos y mínimos de transferencia.
• Si envías ambos, Fintoc realizará todas las validaciones del payment intent.

{
    "eligible_payment": true,
    "error": null
}

{
    "eligible_payment": false,
    "error": {
      "type": "new_contact_error",
      "message": "The amount exceeds the maximum amount permitted for new contacts. For #{institution_name}, the maximum permissible amount is $250,000. This restriction ends at 2024-08-20T16:08:28Z",
      "code": "new_contact_maximum_amount_limit_error",
      "param": "amount",
      "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

​

Incluir un objeto sender_account al crear una Checkout Session

{
  "amount": 1000,
  "currency": "clp",
  "metadata": {
    "order": "#987654321"
  },
  "customer_email": "customer@example.com",
  "payment_method_options": {
    "payment_intent": {
      "sender_account": {
        "holder_id": "12345678-9",
        "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 y no el institution_id, Fintoc usará los límites generales para nuevos contactos, permitiendo que más pagos pasen sin cancelar incorrectamente ninguno.
• Si solo envías el institution_id y no el holder_id, Fintoc solo validará los límites específicos del banco para los montos máximos y mínimos de transferencia.
• Si envías ambos, Fintoc realizará todas las validaciones del payment intent.

​

Proceso de validación

1. Límites específicos de la institución: verificamos si el monto del pago está dentro de los límites permitidos para la institución especificada.
2. Límites para nuevos contactos: para transferencias por primera vez o transferencias dentro de las 24 horas posteriores a la primera transferencia, las instituciones aplican límites más estrictos.
3. Montos máximos de transferencia: nos aseguramos de que el pago no exceda el monto máximo de transferencia permitido para el banco especificado.

​

Respuestas de error

1. Error de límite de monto máximo para nuevo contacto: Fintoc primero verifica si el holder_id ha realizado una transferencia. 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 #{institution_name}, the maximum permissible amount is $250,000. This restriction ends at 2024-08-20T16:08:28Z",
    "code": "new_contact_maximum_amount_limit_error",
    "param": "amount",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

2. Error de límite de número de pagos para nuevo contacto: Fintoc primero verifica si el holder_id ha realizado su primera transferencia 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 in #{institution_name} was reached. This restriction ends at 2024-08-20T16:08:28Z",
    "code": "new_contact_payment_number_limit_error",
    "param": "sender_account",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

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

{
  "error": {
    "type": "amount_error",
    "message": "The amount is lower than the minimum amount permitted for payments by #{institution_name}. Please enter an amount greater than $1000.",
    "code": "minimum_amount_limit_error",
    "param": "amount",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

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

{
  "error": {
    "type": "amount_error",
    "message": "The amount exceeds the maximum amount permitted for payments by #{institution_name}. Please enter an amount less than $70000000.",
    "code": "maximum_amount_limit_error",
    "param": "amount",
    "doc_url": "https://docs.fintoc.com/reference/errors"
  }
}

​

Buenas prácticas

1. Incluye siempre la información de sender_account al crear una Checkout Session para garantizar 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é no se pudo procesar un pago.
3. Realiza ajustes a tu orden para que los usuarios puedan pagar. Estos pueden ser cambiar el monto del pago si es posible o configurar recordatorios para pagos futuros.