¿Cómo funcionan los pagos con APM?

🚧 Early Release — Beta

Este producto está en acceso temprano. Los parámetros, estructuras de respuesta y comportamientos pueden cambiar sin previo aviso. No uses esta versión en producción sin coordinarlo previamente con el equipo de integraciones de 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.

¿Buscas pagos con transferencia bancaria?

La transferencia bancaria es la integración tradicional y no cambia. Consulta Recibe transferencias bancarias.

Disponible solo para integraciones 100% API

El flujo multiprocesador aplica a integraciones directas con la API: el token se solicita desde tu backend. Kajita y Kushki.js aún no soportan el objeto processor.

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:

La entrada elegida...	Es un procesador de...	El token se arma...
Con `supportedFlows` (Yape)	Flujos de pago APM	Con `processor: { name, flowType }`, copiado tal cual de la respuesta; solo `amount` y `currency` siguen requeridos (más `phoneNumber` en `PUSH`).
Sin `supportedFlows`	Transferencia bancaria (tradicional)	Sin el objeto `processor`. Sigue la guía de transferencias bancarias.

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

Procesadores disponibles

Yape — aprobación en la app

`flowType`	Canal	Cómo funciona
`DEEPLINK`	Mobile	Rediriges al pagador al `deepLink` que devuelve el init; se abre la app de Yape en su celular y aprueba el pago.
`PUSH`	Web / Desktop	El pagador ingresa su número de celular en tu checkout (`phoneNumber`, requerido en el token) y Yape le envía una notificación push a su app para que apruebe la compra desde Aprobar compras.

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

Caso	`processor`	Requeridos	Notas
Yape `DEEPLINK`	`{ "name": "Yape Processor", "flowType": "DEEPLINK" }`	`amount`, `currency` (`PEN`), `processor`	—
Yape `PUSH`	`{ "name": "Yape Processor", "flowType": "PUSH" }`	`amount`, `currency` (`PEN`), `processor`, `phoneNumber`	`phoneNumber` es el número celular asociado a la cuenta Yape del pagador.

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:

Token generado	Procesador del comercio	Resultado
Con `processor` Yape	Yape	Continúa (la respuesta trae `ticketNumber` y `consentId`; con `DEEPLINK`, también `deepLink`).
Con `processor`	Otro procesador	`422 E046`.
Sin `processor`	Yape	`422 E046`.

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

Acepta pagos con Yape

Integración con aprobación en la app de Yape

¿Cómo funcionan los pagos con APM?

El modelo: consulta tus procesadores#

El flujo, de punta a punta#

Procesadores disponibles#

Yape — aprobación en la app#

Arma el token según el procesador#

Compatibilidad token ↔ procesador#

Integra cada procesador#