MOCK API · Mercado Pago

Mercado Pago API mock

Simulate Pix, card and boleto payments, and Mercado Pago's notification webhooks, without charging for real. See also the full webhook guide.

Example endpoints

POST /v1/payments

Creates a payment (Pix, card or boleto).

curl

curl -X POST https://httpdrop.com/mock/YOUR_ENDPOINT_ID/v1/payments \
  -H "Content-Type: application/json" \
  -d '{"transaction_amount":100,"payment_method_id":"pix","payer":{"email":"customer@example.com"}}'

Response

{
  "id": 123456789,
  "status": "pending",
  "status_detail": "pending_waiting_transfer",
  "transaction_amount": 100,
  "payment_method_id": "pix"
}

GET /v1/payments/:id

Checks a payment's status.

curl

curl https://httpdrop.com/mock/YOUR_ENDPOINT_ID/v1/payments/123456789

Response

{
  "id": 123456789,
  "status": "approved",
  "status_detail": "accredited",
  "transaction_amount": 100
}

Webhook example

EVENT payment.updated

Configure this as a Mock Rule response body and use Response Sequences or the SSE mode to push it — see the webhook architecture guide.

{
  "action": "payment.updated",
  "api_version": "v1",
  "type": "payment",
  "data": { "id": "123456789" }
}

Transparency note: The examples above are illustrative, based on Mercado Pago's public documentation — not the official source and don't cover every field. Always check the official Mercado Pago docs for your integration's exact details. If anything changed, let us know.

Start mocking Mercado Pago now

Create a free endpoint, no credit card required, and paste the rules above.

Create free mock All providers →