Mercado Pago - Crear Preferencia

Descripcion

Crea una preferencia de pago para Checkout Pro de Mercado Pago. Permite configurar items, URLs de retorno, datos del pagador y opciones de pago.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Mercado Pago
items	string	Sí	Items en formato JSON (array)
payer_email	string	No	Email del pagador
payer_name	string	No	Nombre del pagador
payer_phone	string	No	Teléfono del pagador
external_reference	string	No	Referencia externa
success_url	string	No	URL de redirección en éxito
failure_url	string	No	URL de redirección en fallo
pending_url	string	No	URL de redirección en pendiente
notification_url	string	No	URL para webhooks IPN
auto_return	select	No	Comportamiento de retorno automático
expires	boolean	No	Si la preferencia expira
expiration_date_from	string	No	Fecha desde la cual es válida
expiration_date_to	string	No	Fecha hasta la cual es válida

Credenciales

Este modulo requiere una credencial de tipo mercadopago con los siguientes campos:

• Access Token: Token de acceso de Mercado Pago (obtenido en el panel de desarrolladores)

Formato de Items

[
  {
    "title": "Producto 1",
    "quantity": 2,
    "unit_price": 100.50,
    "currency_id": "ARS",
    "description": "Descripción opcional",
    "picture_url": "https://..."
  }
]

Salida

{
  "success": true,
  "preference": { ... },
  "preference_id": "123456789-abc",
  "init_point": "https://www.mercadopago.com.ar/checkout/v1/redirect?...",
  "sandbox_init_point": "https://sandbox.mercadopago.com.ar/checkout/v1/redirect?...",
  "message": "Preferencia 123456789-abc creada"
}

Uso del Checkout Pro

1. Crea la preferencia con este módulo
2. Redirige al usuario a init_point (producción) o sandbox_init_point (testing)
3. El usuario completa el pago en la interfaz de Mercado Pago
4. El usuario es redirigido a tus URLs configuradas
5. Recibe notificaciones via webhook en notification_url

Ejemplo de Uso

{
  "items": "[{\"title\": \"Producto 1\", \"quantity\": 2, \"unit_price\": 100.50, \"currency_id\": \"ARS\"}]",
  "payer_email": "cliente@email.com",
  "external_reference": "ORDER-123",
  "success_url": "https://mitienda.com/success",
  "failure_url": "https://mitienda.com/failure",
  "notification_url": "https://mitienda.com/webhook"
}

API Utilizada

• Endpoint: POST /checkout/preferences
• Documentacion: Mercado Pago Preferences API

Notas

• El campo items debe ser un JSON array serializado como texto
• Cada item requiere al menos title, quantity y unit_price
• Las URLs de retorno son opcionales pero recomendadas para una buena experiencia de usuario
• El init_point devuelto es la URL para redirigir al usuario al checkout

Nodos relacionados

• MercadopagoGetPayments - Obtener pagos resultantes
• MercadopagoCreateRefund - Crear reembolso
• MercadopagoCreateCustomer - Crear cliente