Mopago Developers
Login Empezar
Mopago Developer Platform v1

Infraestructura API para construir productos financieros sobre Mopago.

Integra pagos, wallets, transferencias y webhooks con una capa documentada, trazable y pensada para equipos tecnicos que necesitan pasar de UAT a produccion sin friccion.

Crear cuenta developer Leer documentacion
Client credentials Webhooks auditables UAT y produccion
POST /api/v1/auth/token 
// Exchange app credentials for an access token
curl -X POST https://developers-uat.mopago.com/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "developer_identifier_token": "dev_40_char_sha",
    "application_identifier_token": "app_40_char_sha",
    "client_id": "mopago_cli_live",
    "secret_key": "mopago_sec_live"
  }'

{
  "token_type": "Bearer",
  "access_token": "mpp_app_...",
  "expires_in": 3600
}
Quick start

De cuenta aprobada a primera llamada en minutos.

El flujo separa identidad del developer, credenciales de app y tokens de consumo para que cada integracion sea clara y auditable.

01

Registra tu cuenta developer

Completa el formulario, espera aprobacion del administrador y entra al portal.

02

Crea una aplicacion

Asocia `client_id` y `secret_key` a una app para separar ambientes, permisos y trazabilidad.

03

Solicita un token de aplicacion

Usa el flujo de credenciales para obtener `mpp_app_*` y consumir endpoints proxy.

Features

Herramientas de plataforma, no solo endpoints.

A

Autenticacion por aplicacion

Tokens `mpp_app_*` con hash local y bearer upstream cifrado en reposo.

L

Logs y auditoria

Cada intento de auth y request proxy queda trazado para soporte y compliance.

W

Webhooks operables

Configura URL por aplicacion y prepara flujos idempotentes para eventos de pago.

S

Ambientes separados

Valida integraciones en developers-uat.mopago.com antes de activar operacion productiva.

D

DX documentada

Guias, ejemplos y referencias para reducir ida y vuelta con soporte tecnico.

P

Portal self-service

Gestiona aplicaciones, credenciales, perfil y endpoints desde un panel dedicado.

API examples

Contratos simples para flujos criticos.

Emite tokens de aplicacion y consume procesos Mopago disponibles hoy desde un gateway normalizado.

POST /api/v1/auth/tokenApp token
GET /api/v1/wallet/profilePerfil Mopago
GET /api/v1/wallet/current-balanceSaldo actual
POST /api/v1/payment-linksLink de pago
GET /api/v1/payment-links/{id}Consulta link
payment-link.js 
const baseUrl = "https://developers-uat.mopago.com/api/v1";

const response = await fetch(`${baseUrl}/payment-links`, {
  method: "POST",
  headers: {
    "Authorization": "Bearer mpp_app_...",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    amount: 12500,
    currency: "PEN",
    reference: "order_1024"
  })
});

const paymentLink = await response.json();
Webhooks

Eventos disenados para integraciones resilientes.

Configura un endpoint HTTPS por aplicacion para recibir eventos normalizados de links de pago.

Payload consistente

{
  "source": "mopago_developer_platform",
  "event": "payment_link.paid",
  "payment_id": "order_1024",
  "developer_code": "mpp_dev_00000001",
  "payload": {
    "Payload": {
      "MensajePago": {
        "IdentificadorOrdenVenta": "order_1024",
        "EstadoTransaccion": "APROBADA"
      }
    }
  }
}

Buenas practicas

  • Valida el esquema antes de procesar.
  • Responde `2xx` y mueve trabajo pesado a background jobs.
  • Registra `payment_id` para evitar dobles impactos.
  • Monitorea entregas fallidas desde tu panel.
SDKs

Integracion lista para tu stack.

Los SDKs oficiales pueden publicarse sobre estos contratos sin cambiar la arquitectura del portal.

Node.jsnpm i @mopago/sdk
PHPcomposer require mopago/sdk
RESTOpenAPI-ready
Production path

Construye tu integracion Mopago con una base solida.

Crea tu cuenta, registra una aplicacion y usa la documentacion para avanzar desde la primera llamada hasta webhooks operativos.

Crear cuenta developer Explorar docs