Solicitar un token de Transfer In

Un token de Transfer In te permite iniciar una transacción de Transfer In.

Expiración del token
Los tokens expiran a los 30 minutos y solo pueden usarse para una única transacción (incluso si la transacción fue errónea). Deberás solicitar un nuevo token cuando expire.

🚧 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.

🇵🇪 Perú — Flujos de Yape (DEEPLINK / PUSH)

Para pagar con Yape, envía el objeto opcional processor copiando los valores que devuelve Consultar la configuración de Transfer In (GET /transfer/v1/config): "processor": { "name": "Yape Processor", "flowType": "DEEPLINK" | "PUSH" }. Elige el flujo según el canal del pagador: DEEPLINK para mobile, PUSH para web o desktop. Cuando envías processor, solo amount y currency siguen siendo requeridos; el flujo PUSH requiere además phoneNumber (el número Yape del pagador). Yape opera solo en PEN.

La integración tradicional no cambia: un token sin processor se comporta exactamente como antes.

Solo integraciones directas por API: solicita el token desde tu backend. Kajita y Kushki.js aún no soportan el objeto processor.

curl --location '/transfer/v1/tokens' \ --header 'Public-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data-raw '{ "amount": { "subtotalIva": 100000, "subtotalIva0": 0, "iva": 10000, "extraTaxes": { "tasaAeroportuaria": 0, "agenciaDeViaje": 0, "iac": 0 } }, "callbackUrl": "https://kushki.com", "userType": "1", "documentType": "DNI", "documentNumber": "12345678", "paymentDescription": "Description of the payment.", "email": "user@example.com", "currency": "PEN" }'

Expiración del token

Request