mp-notifications

Validate Mercado Pago webhook and IPN notifications with HMAC-SHA256 signatures.

24|14|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/mercadopago/mercadopago-claude-marketplace --skill mp-notifications
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-notifications
Source: https://github.com/mercadopago/mercadopago-claude-marketplace/tree/main/plugins/mercadopago/skills/mp-notifications
Command: npx skills add https://github.com/mercadopago/mercadopago-claude-marketplace --skill mp-notifications

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Centralize and simplify the receipt, validation, and reliable processing of Mercado Pago webhook and IPN notifications, ensuring secure delivery and correct integration with merchant systems.

Core Features & Use Cases

  • Webhook (v2) support with JSON payloads and HMAC-SHA256 signature validation for secure event handling.
  • IPN (Legacy) guidance for compatibility with older integrations and migration considerations.
  • Idempotent processing, retry guidance, and debugging tips to handle delivery retries and missing notifications.
  • Local development tips, dashboard configuration hints, and cross-product notification type coverage.

Quick Start

Configure your webhook URL in the Mercado Pago Developer Dashboard and implement a handler that validates the x-signature header, processes incoming events, and stores idempotent results.

Frequently Asked Questions about mp-notifications

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Mercado Pago webhook x-signature headers?

Validate Mercado Pago webhook x-signature headers using HMAC-SHA256 to verify payload integrity and ensure secure event delivery. Webhook v2 uses JSON payloads with this cryptographic signature for authentic notification handling.

What is the difference between Mercado Pago Webhook v2 and legacy IPN?

Mercado Pago Webhook v2 uses JSON payloads with HMAC-SHA256 signature validation for secure event handling, while legacy IPN provides compatibility for older integrations. Guidance covers migration considerations and cross-product notification type coverage.

Why does my Mercado Pago webhook keep retrying or missing notifications?

Mercado Pago webhook retries and missing notifications occur when delivery fails or processing isn't idempotent. Implement idempotent processing, follow retry guidance, and use debugging tips to handle delivery failures and ensure reliable notification receipt.

How to set up Mercado Pago webhooks for local development?

Set up Mercado Pago webhooks for local development by configuring your webhook URL in the Mercado Pago Developer Dashboard, implementing a handler to validate x-signature headers, and using local development tips to test incoming events.

Do I need to configure notification types per product for Mercado Pago webhooks?

Yes, configuring notification types per product is required for Mercado Pago webhooks to ensure correct cross-product notification management. The dashboard configuration hints guide selecting specific notification types for each product integration.