yape-api.com

Reconciliación de pagos Yape,
en tu sistema, en tiempo real.

Conecta un Android a tu línea Yape y recibe cada pago confirmado en tu POS, e-commerce o ERP vía API REST y webhooks firmados — sin depender de que un cajero mire la pantalla del celular.

Ir al dashboard Ver documentación (OpenAPI)Descargar Collector (APK debug)

APK de prueba, sin firma de release — Android te va a pedir permitir “instalar apps de fuentes desconocidas” la primera vez.

Cómo funciona

Instala el Collector

Un Android (nuevo o viejo) dedicado a tu línea Yape lee las notificaciones de pago, nada más.

Se normaliza y deduplica

El backend parsea el texto, extrae monto/nombre/código de seguridad, y descarta duplicados automáticamente.

Llega a tu sistema

Vía webhook firmado (HMAC) o consultando la API REST — tú decides cómo integrarlo.

En una sola llamada

curl -X POST https://yape-api.com/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "tu_client_id",
    "client_secret": "tu_client_secret"
  }'

# → { "access_token": "eyJ...", "expires_in": 900 }

curl https://yape-api.com/v1/transactions \
  -H "Authorization: Bearer eyJ..."

Webhook: payment.received

{
  "event": "payment.received",
  "transaction": {
    "id": "a950cc77-...",
    "amount": 25.00,
    "currency": "PEN",
    "sender_name_raw": "Juan Sal*",
    "security_code": "823",
    "source_channel": "yape_to_yape",
    "confidence_score": 0.95,
    "occurred_at": "2026-09-22T18:23:25.119Z"
  }
}

Endpoints principales

POST/v1/oauth/tokenClient credentials → JWT

GET/v1/devicesListar tus devices collector

GET/v1/devices/{id}/healthEstado online/offline

GET/v1/transactionsFiltrar por fecha, monto, estado, referencia

PATCH/v1/transactions/{id}Confirmar, disputar, setear tu referencia

POST/v1/webhooksSuscribirte a payment.received

GET/v1/webhooks/{id}/deliveriesHistorial de entregas + reintento manual

Yape Payments API es un servicio independiente, no afiliado a Yape ni al BCP. Lee notificaciones del sistema Android en un dispositivo de tu propiedad — no accede a cuentas ni credenciales bancarias. El collector debe usarse solo sobre tu propia línea de negocio, con consentimiento informado del personal que opere el dispositivo.

Reconciliación de pagos Yape, en tu sistema, en tiempo real.