Saltar al contenido principal

Credix

Credix permite cobrar un pago cuando el comprador usa su tarjeta Credix para pagar en cuotas mensuales o de contado.

A diferencia de SINPE, Credix es una autorización de tarjeta: el cobro se procesa en el momento de confirmar la intención de pago, sin transferencias ni redirección a un sistema externo. La intención pasa directamente a succeeded cuando la autorización es aprobada.

Este método de pago está disponible solo bajo solicitud y soporta pagos en CRC y USD. Los plazos de cuotas disponibles y los montos mínimos dependen de la configuración de tu comercio.

Habilitación

Credix debe ser habilitado para tu cuenta por el equipo de ONVO, junto con la configuración de comisiones por plazo. Solicitá la habilitación antes de integrar.

Referencia API relacionada​

Antes de empezar​

  • Solicitá la habilitación de Credix al equipo de soporte de ONVO.
  • Configurá webhooks y escuchá payment-intent.succeeded.
  • Usá CRC o USD como moneda de la intención de pago.
  • Tené en cuenta los montos mínimos por plazo definidos para tu comercio.
  • Solo se aceptan tarjetas Credix.

Cuotas disponibles​

Al confirmar la intención indicás la cantidad de cuotas en credixInstallmentMonths:

  • 1 — pago contado (un solo pago con la tarjeta Credix, sin financiamiento).
  • 3, 6, 10, 12, 18, 24 — planes de cuotas mensuales.

Los plazos realmente disponibles dependen de las comisiones que tu comercio tenga configuradas en el dashboard y del monto de la transacción. Cada plazo puede tener un monto mínimo, por lo que no todos están disponibles para cualquier monto.

Flujo​

  1. Creá una intención de pago por el monto exacto a cobrar.
  2. Creá un método de pago con type: "credix" y los datos de la tarjeta Credix.
  3. Confirmá la intención con el paymentMethodId y credixInstallmentMonths.
  4. Credix autoriza el pago en el momento: la intención pasa a succeeded si es aprobada o a failed si es rechazada.
  5. Esperá el webhook payment-intent.succeeded antes de marcar el pago como completado.

Crear la intención de pago​

curl https://api.onvopay.com/v1/payment-intents \
  -X POST \
  -H "Authorization: Bearer $ONVO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 500000,
    "currency": "CRC",
    "description": "Pago Credix #1001"
  }'

Crear el método de pago​

Indicá los datos de la tarjeta Credix dentro del objeto credix.

curl https://api.onvopay.com/v1/payment-methods \
  -X POST \
  -H "Authorization: Bearer $ONVO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "credix",
    "credix": {
      "number": "4111111111111111",
      "expMonth": 12,
      "expYear": 2026,
      "cvv": "123",
      "holderName": "María Rodríguez"
    },
    "billing": {
      "name": "María Rodríguez",
      "email": "maria@example.com"
    }
  }'

Confirmar la intención​

Al confirmar una intención con un método de pago Credix, el campo credixInstallmentMonths es requerido. Usá 1 para pago contado o uno de los plazos de cuotas que tu comercio tenga configurados en el dashboard.

curl https://api.onvopay.com/v1/payment-intents/$PAYMENT_INTENT_ID/confirm \
  -X POST \
  -H "Authorization: Bearer $ONVO_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethodId": "cl502zv0d0127ebdp3zt27651",
    "credixInstallmentMonths": 3
  }'

La API valida las cuotas al confirmar:

  • Si omitís credixInstallmentMonths, responde con el error payment_intents.credix_missing_installment_months (400).
  • Si enviás un plazo que no está configurado o habilitado para tu comercio, o que no cumple el monto mínimo de ese plazo, responde con el error payment_intents.credix_fee_not_configured (400).

En ese caso, ajustá el plazo (o el monto) según los plazos que tu comercio tenga configurados en el dashboard. No marques el pago como exitoso en tu sistema hasta recibir payment-intent.succeeded.

Checkout y SDK​

Si cobrás a través de Checkout o el SDK, no necesitás implementar este flujo por API. Cuando Credix está habilitado para tu comercio y el monto cumple los mínimos, aparece automáticamente como opción de pago y el comprador elige el plan de cuotas dentro de la interfaz de pago. En ese caso, la selección de cuotas se maneja en el Checkout y no tenés que enviar credixInstallmentMonths manualmente.

Credix no está disponible para subscripciones ni para las monedas no soportadas.

Pruebas​

En modo de prueba, usando llaves onvo_test_, los números definidos en métodos de pago de prueba para Credix simulan distintos escenarios de autorización. No necesitás usar una tarjeta Credix real.

Usá esos números para simular autorizaciones aprobadas y declinadas.