Cómo integrar QR modelo atendido
Para cobrar a través de un código QR modelo atendido, deberás crear una orden y asociarla a la caja en la quieras cobrar.
Flujo del modelo
Te explicamos cómo funciona el modelo atendido:
- El punto de venta registra un pedido (1a) y crea una orden asignada a una caja (1b). En este momento la orden se encuentra disponible para ser escaneada (2).
- Cuando el cliente escanea el QR (3) con la orden y realiza el pago (5), se recibe una notificación IPN (4a y 6b) al servidor del vendedor. Con esos datos, se obtiene el estado de la orden (7a), para validar que esté cerrada o siga abierta, pendiente de pago.
Crear una orden
curl
curl -X PUT \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/stores/EXTERNAL_STORE_ID/pos/EXTERNAL_POS_ID/orders \
-d \
{
"external_reference": "order-id-1234",
"title": "Title",
"description": "Mercado Pago",
"notification_url": "www.yourserver.com",
"expiration_date": "2023-08-22T16:34:56.559-04:00",
"total_amount": 100.0,
"items": [
{
"sku_number": "KS955RUR",
"category": "FOOD",
"title": "Item1",
"description": "Item1 Mercado Pago",
"unit_price": 20,
"quantity": 5,
"unit_measure": "unit",
"total_amount": 100
}
],
"sponsor": {
"id": 446566691
}
}Puedes obtener más información en la Referencias de API.
Una vez creada la orden, ya se encuentra disponible para ser escaneada y pagada.
Eliminar una orden
Para eliminar la orden asociada a un QR antes de que expire por vigencia, o se cierre, puedes hacerlo a través del siguiente método:
curl
curl -X DELETE \
-H 'Authorization: Bearer ACCESS_TOKEN' \
https://api.mercadopago.com/instore/qr/seller/collectors/USER_ID/pos/EXTERNAL_POS_ID/orders La respuesta será un HTTP 204 No Content.
Recibe notificaciones de tus órdenes
Las notificaciones IPN (Instant Payment Notification) son la forma automática de aviso de la creación de nuevas órdenes y las actualizaciones de sus estados. Por ejemplo si fueron aprobados, rechazados o si se encuentran pendientes.
Implementa IPN de merchant_order junto con una búsqueda de la orden por external_reference como método de contigencia.