Pagos con Puntos BBVA

Permite a los clientes pagar total o parcialmente con sus Puntos BBVA al momento de realizar una compra.

¿Cómo funciona?

Cuando el cliente elige pagar con Puntos BBVA, el cargo se procesa descontando los puntos disponibles en su tarjeta BBVA. En caso de devolución, los puntos no se regresan como puntos, sino que se acreditan al cliente en forma de dinero (crédito en su tarjeta).


Crear una orden con Puntos BBVA

Para activar el cobro con puntos, incluye el campo loyalty_points con valor true dentro del objeto de la orden.

Endpoint

POST https://api.conekta.io/orders

Ejemplo de solicitud

{
  "currency": "MXN",
  "customer_info": {
    "name": "John Constantine",
    "email": "[email protected]",
    "phone": "+5213353319758"
  },
  "line_items": [
    {
      "name": "Tenis Futurista",
      "unit_price": 50000,
      "quantity": 1
    }
  ],
  "charges": [
    {
      "payment_method": {
        "type": "card",
        "token_id": "tok_test_visa_4242"
      }
    }
  ],
  "loyalty_points": true
}

Parámetros

ParámetroTipoDescripción
loyalty_pointsbooleanActiva el cobro con Puntos BBVA. Envía true para descontar los puntos disponibles del cliente.

Devoluciones

Las devoluciones funcionan con el flujo estándar de Conekta. No se requiere ningún parámetro adicional.

⚠️ Importante: Cuando se procesa una devolución sobre un cargo realizado con Puntos BBVA, los puntos no se reintegran como puntos. El cliente recibe el importe correspondiente como crédito en dinero en su tarjeta BBVA.

Endpoint

POST https://api.conekta.io/orders/{order_id}/refunds

Ejemplo de solicitud

{
  "reason": "customer_request",
  "amount": 50000
}

Consideraciones

  • Solo disponible para merchants integrados por API.
  • El sistema aplica los puntos de forma automática según el saldo disponible del cliente:
    • Si tiene más puntos de los necesarios, se descuenta únicamente el equivalente al monto del cargo.
    • Si tiene exactamente los puntos necesarios, se utilizan todos sus puntos.
    • Si tiene menos puntos de los necesarios, el cargo se divide: una parte se cubre con puntos y el resto se cobra en dinero.