¿Cómo funcionan los pagos con APM?

16 octubre 2026

Te explicamos cómo funcionan los métodos alternativos de pago (APM) y el flujo multiprocesador en Kushki

Te explicamos cómo funcionan los métodos alternativos de pago (APM) y el flujo multiprocesador en Kushki

Los métodos alternativos de pago (APM) permiten a tus clientes pagar sin tarjeta, con billeteras digitales. En Perú hoy puedes aceptar pagos con Yape: el cliente aprueba el pago directamente en su app de Yape, por redirección directa a la app (DEEPLINK, desde mobile) o mediante una notificación push al número de celular del pagador (PUSH, desde web o desktop).

Los APM funcionan con un flujo multiprocesador: una sola integración con la API de Kushki, en la que el procesador que uses en cada transacción define cómo integras y cómo paga tu cliente. Tu comercio puede tener habilitado uno o varios procesadores, y a medida que se habiliten más, tu integración no cambia: solo consultas qué procesadores tienes y armas el token según cada uno.

El modelo: consulta tus procesadores

Toda integración APM empieza por la misma pregunta: ¿qué procesadores tiene mi comercio? La respuesta vive en un solo lugar:

GET /transfer/v1/config (con tu credencial pública) → processors[]

Cada entrada de la respuesta te dice cómo continuar:

Si tu comercio tiene varios procesadores, usa supportedFlows de cada entrada para saber cómo armar el token con cada uno. Si tiene uno solo puedes omitir la consulta, pero intégrala desde el inicio: es la regla del producto a medida que se habilitan más procesadores y flujos.

El flujo, de punta a punta

1. El comercio llama a GET /transfer/v1/config y recibe processors[], con los supportedFlows de cada entrada.
2. Elige el procesador y el flujo (DEEPLINK o PUSH).
3. Solicita el token con POST /transfer/v1/tokens, enviando processor: { name, flowType } (y phoneNumber en PUSH), y recibe 201 { token }.
4. Inicia la transacción con POST /transfer/v1/init { token, amount }. Con DEEPLINK recibe deepLink, ticketNumber y consentId: redirige al pagador a la app de Yape. Con PUSH recibe ticketNumber y consentId: el pagador recibe la notificación push en su app de Yape.
5. El pagador aprueba el pago en la app de Yape.
6. Kushki informa el estado final por webhook o con Get Status.

Procesadores disponibles

Yape — aprobación en la app

Recibes el estado final por webhook o consultándolo con Get Status. La guía completa está en Acepta pagos con Yape.

Arma el token según el procesador

El objeto processor no admite propiedades adicionales (produce 400) y flowType no tiene valor por defecto: sus valores se copian de la consulta de procesadores, sin alias.

Compatibilidad token ↔ procesador

El token queda ligado al procesador con el que fue generado; POST /transfer/v1/init lo valida:

Si recibes E046, revisa la consulta de procesadores y regenera el token con el procesador correcto. Los errores de cada caso están en la sección Errores de la guía Acepta pagos con Yape.

Integra cada procesador