MosendDeveloper

Pagos (Mercado Pago)

Integración Mercado Pago (preferencias, recargas, webhooks de pago).

Base path: /·3 endpoints·Source: mosend-wb-backend/src/modules/mercado-pago/mercado-pago.controller.ts
POST/organizations/:orgId/wallet/recharge
bearer

Crea preference de recarga de saldo. Devuelve URL de checkout.

Path params

  • orgIdstringrequerido

Body

CreateRechargeDtoparámetro: dto

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/wallet/recharge' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"name": "string","description": "string"}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/webhooks/mercado-pago
público

Webhook IPN de Mercado Pago. Valida firma y procesa pagos.

Query params

  • idstring
  • typestring

Body

MpWebhookBodyparámetro: body

Respuestas

  • 200
curl -X POST 'https://api.mosend.dev/webhooks/mercado-pago' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://tu-backend.com/webhooks/mosend","events": ["message.new","message.status"]}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "url": "https://tu-backend.com/webhooks/mosend",
    "events": [
      "message.new",
      "message.status"
    ]
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/billing/invoices/:invoiceId/pay
bearer

Crea preference MP para pagar una factura. Devuelve URL de checkout.

Path params

  • orgIdstringrequerido
  • invoiceIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/billing/invoices/00000000-0000-0000-0000-000000000000/pay' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}