Lane · Documentación

Guías

Cobrar a cuotas

Solo la tarjeta de crédito hace cuotas, y el plan lo decide el banco emisor, no tú.

Hay dos formas de llegar a un cobro a cuotas, y no funcionan igual. En la pantalla de pago solo puedes abrir o cerrar la puerta: si la abres, el comprador elige el plan con su banco. En un cobro directo contra una tarjeta guardada sí puedes fijar la cantidad.

En la pantalla de pago

Abrir la opción de cuotas

{
  "amount": 89000000,
  "currency": "COP",
  "description": "Pedido #4821",
  "checkout_options": { "allow_installments": true }
}

Con eso, la pantalla le ofrece cuotas a quien pague con crédito. Cuántas y a qué interés lo define el emisor: Lane no impone el plan ni lo conoce de antemano.

En un cobro directo

Contra una tarjeta ya guardada sí puedes pedir una cantidad concreta. El mínimo es 2: para un pago normal, omite el objeto installments en vez de mandar 1.

Tres cuotas

curl -X POST https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/payments \
  -H "Authorization: Bearer sk_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 89000000,
    "currency": "COP",
    "instrument_id": "c1a9…",
    "initiator": "customer",
    "cvv": "123",
    "order_type": "purchase",
    "installments": { "quantity": 3 }
  }'

Verifica el BIN antes de ofrecer

Una tarjeta débito puede aprobar el cobro con una sola cuota aunque hayas pedido tres, sin avisar. Consulta el BIN —los primeros 6 a 8 dígitos— y ofrécele cuotas al comprador solo si supports_installments viene en true.

Consultar un BIN

curl "https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/bins/518617" \
  -H "Authorization: Bearer sk_test_…"

Respuesta 200

{
  "object": "bin",
  "bin_number": "518617",
  "brand": "MASTERCARD",
  "product": "CREDIT",
  "country": "CO",
  "issuer": "…",
  "supports_installments": true
}

La tarjeta de prueba no sirve para esto. La 4111111111111111 del sandbox es débito. Aprueba cobros, pero no prueba cuotas. Para homologar el flujo necesitas una tarjeta de crédito real en sandbox: pídesela a soporte.

Esta página en markdown: /docs/guias/cuotas.md · Toda la documentación: /docs/llms-full.txt