Verificación de elegibilidad de pagos

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

​

Usar el 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"
  },
  "recipient_account": {
     "holder_id": "774981128",
     "institution_id": "cl_banco_estado",
     "type": "checking_account",
     "number": "1251353"
  }
}

• 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 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.

{
    "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

{
  "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 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 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 de 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 permitido de transferencia para el banco especificado.

​

Respuestas de error

1. Error de límite máximo de monto para nuevo contacto: Fintoc primero verifica si el holder_id ha hecho 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 hecho su primera transferencia durante el mismo día. Si la 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 mínimo de monto: Fintoc verifica si el monto es menor al 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 máximo de monto: Fintoc verifica si el monto es menor al 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"
  }
}

​

Mejores prácticas

1. Siempre incluye la información de sender_account al crear una Checkout Session 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.