BR Integrations

How to mock Mercado Pago webhooks

Simulate Pix, boleto and card payment notifications without a Mercado Pago account

The problem: testing payments without paying

Integrating with Mercado Pago involves webhooks — HTTP notifications sent when a payment changes status. In development, you don't want to depend on MP's infrastructure for every test. Each test requires a real transaction or sandbox setup.

With httpdrop you create an endpoint that simulates exactly the payload Mercado Pago would send — and also receives notifications from your system to inspect them in real time.

Step 1 — Create the endpoint and apply the template

  1. 1
    Create a new endpoint. In the Templates tab, select "Mercado Pago". The system automatically creates POST /v1/payments, GET /v1/payments/{id}, POST /webhook/payment routes and a CRUD table with 5 seed records.
  2. 2
    Copy the endpoint URL: https://httpdrop.com/mock/YOUR_ID

Step 2 — Simulate payment status cycles with sequences

Use Sequence Rules to simulate the full payment lifecycle: pendingapprovedrejected. Each GET to /v1/payments/{id} returns the next status in the sequence.

Step 3 — Inspect real-time notifications

With the httpdrop inspector open, send a webhook from your system to the endpoint. You'll see headers (including MP's X-Signature), the full payment event body, response latency and HTTP status.

💡
CI/CD tip: Set MP_WEBHOOK_URL pointing to the httpdrop endpoint in your pipeline. Integration tests will simulate the full payment cycle automatically — no MP sandbox required.
Ready to implement? Check the full technical documentation with API reference, code examples and detailed parameters.
View docs →