Recuperar pagos recurrentes

Para que la estrategia de reintentos funcione, tu sistema necesita saber inmediatamente cuándo falla un pago y por qué motivo. Para eso, es necesario que configures tus notificaciones Webhooks y recibas alertas sobre la creación o actualización de un pago, lo que te permitirá tomar las acciones pertinentes.

Asegúrate de haber configurado tus notificaciones Webhooks para el tópico Pagos (payment). Si todavía no lo hiciste, sigue el paso a paso de la documentación de notificaciones Webhooks.

Ante eventos de creación o actualización de un pago, Mercado Pago enviará una notificación con el siguiente formato:

json
{
  "id": 12345,
  "live_mode": true,
  "type": "payment",
  "date_created": "2015-03-25T10:04:58.396-04:00",
  "user_id": 44444,
  "api_version": "v1",
  "action": "payment.created",
  "data": {
    "id": "132260878091"
  }
}

Esta notificación contiene solo el ID del pago, no su estado. Al recibirla, tu servidor debe consultar inmediatamente la API de Pagos para obtener los detalles completos.

Para consultar el estado de un pago, envía una solicitud /v1/payments/{id}GET utilizando el ID recibido en la notificación.

curl -X GET \
  'https://api.mercadopago.com/v1/payments/{id}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

En la respuesta, localiza los dos campos que indican el código de rechazo y determinan tu próxima acción:

No todos los rechazos deben tratarse de la misma forma. La categorización correcta del error a partir de su status_detail determina si es necesario aplicar una lógica de reintento o si es necesario contactar al pagador.

Según su naturaleza, los rechazos se agrupan en tres categorías:

• Soft Declines (errores temporales): el rechazo es temporal y hay alta probabilidad de aprobación en un reintento. Conviene reintentar siguiendo una cadencia.
• Hard Declines (errores permanentes): el rechazo no se resuelve reintentando, e insistir puede afectar tu reputación con los adquirentes. No reintentes; el cliente debe actualizar su medio de pago.
• Errores de llenado o configuración: requieren una corrección previa, ya sea del cliente o de tu integración. Reintenta solo después de corregir el dato o la configuración.

Mira cómo reconocer el tipo de error y qué acciones debes implementar a continuación.

En la mayoría de los flujos, Mercado Pago no contacta al cliente final en tu nombre. El gerenciamiento de la comunicación en casos de rechazo es responsabilidad del comercio y es tan importante como el reintento técnico.

Por esto, es necesario que definas una estrategia de comunicación teniendo en cuenta los siguientes puntos:

• Define una ventana de recuperación: determina cuánto tiempo tiene el cliente para resolver el motivo de rechazo del pago antes de suspender el servicio.

• Segmenta la comunicación por tipo de error:

  • Soft Declines: usa un tono de baja fricción. Comunica que hubo un problema temporal y que el reintento se hará automáticamente.
  • Hard Declines: usa un tono de urgencia. Informa que el servicio está en riesgo de suspensión y solicita la actualización inmediata del medio de pago.

• Provee un enlace de actualización seguro: dirige al cliente a un portal seguro donde pueda actualizar su medio de pago, nunca solicites sus datos por otros medios. Cuando el cliente realice su actualización, ejecuta el cobro pendiente de inmediato.

Para más información sobre cómo mejorar la aprobación de pagos, consulta las recomendaciones para mejorar la aprobación.