Iniciar transacción

Inicia la transacción con un token de Transfer In entregado por Kushki que representa el pago del cliente.

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

Cuando el token se creó con el objeto processor ({ "name": "Yape Processor", "flowType": "DEEPLINK" | "PUSH" }) no hay redirección bancaria: la respuesta depende del flujo.

PUSH — la respuesta incluye ticketNumber y consentId. Yape envía una notificación push al phoneNumber enviado en el token; indica al pagador que la apruebe en la app de Yape.

DEEPLINK — la respuesta incluye además deepLink. Redirige al pagador a esa URL tal como la recibes, sin modificar sus parámetros (en el navegador móvil abre la app de Yape).

El cuerpo de la solicitud es el mismo del flujo tradicional. El resultado final (aprobado, rechazado, expirado) llega por tu webhook; usa transactionReference para correlacionarlo.

Compatibilidad token ↔ procesador

El token queda ligado al procesador para el que fue generado. Si el token no coincide con el procesador configurado para tu comercio (p. ej., un token con processor en un comercio resuelto a otro procesador, o un token tradicional en un comercio configurado con Yape), este endpoint devuelve 422 E046. Consulta Consultar la configuración de Transfer In y genera el token para el procesador correcto.

curl --location '/transfer/v1/init' \ --header 'Private-Merchant-Id;' \ --header 'Content-Type: application/json' \ --data '{ "token": "string", "amount": { "subtotalIva": 0, "subtotalIva0": 0, "iva": 0, "extraTaxes": { "iac": 0, "tasaAeroportuaria": 0, "agenciaDeViaje": 0, "propina": 0, "tip": 0, "stateTax": 0, "municipalTax": 0, "reducedStateTax": 0 } }, "metadata": { "key0": "string", "key1": "string", "key2": "string" }, "fullResponse": "v2", "expirationDate": "2019-08-24T14:15:22.123Z", "webhooks": { "webhooks": [ { "events": [ "approvedTransaction", "declinedTransaction" ], "headers": [ { "label": "json", "value": "12" } ], "urls": [ "https://eof2hhkrta4ooo1.m.pipedream.net" ] } ] } }'

{ "redirectUrl": "https://api-uat.kushkipagos.com/transfer/v1/agent?token=a0be81f9856540e08ced6f5fd4f5732f&mid=20000000106212540000", "transactionReference": "aef8884f-cd4d-4b9b-9efa-ad582629e4f2" }

Request

Responses