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ámetro | Tipo | Descripción |
|---|---|---|
loyalty_points | boolean | Activa 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.
Updated about 8 hours ago
