Iniciar transacción

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

🇨🇴 Colombia — Flujo Bre-B

Cuando el token se creó con el objeto processor ({ "name": "Bre-B Credibanco Processor", "flowType": "QR" }), la respuesta incluye el campo qr en lugar de redirectUrl: no hay redirección bancaria. Muestra el QR para que el cliente lo escanee con su app bancaria.

El QR expira en 10 minutos. Después, solicita un nuevo token y vuelve a llamar a este endpoint.
Para invalidar un QR activo antes, usa Cancelar transacción (PATCH /transfer/v1/cancel/{token}).

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 Bre-B), este endpoint devuelve 422 E046. Si tu comercio no tiene las llaves del procesador Bre-B configuradas, devuelve 404 E049. Consulta Consultar la configuración de Transfer In y genera el token para el procesador correcto.

curl --location 'https://api-uat.kushkipagos.com/transfer/v1/init' \ --header 'Private-Merchant-Id: 68sc9a1d38824acbb78b5bdd1fa3773d' \ --header 'Content-Type: application/json' \ --data '{ "token": "string", "amount": { "subtotalIva": 0, "subtotalIva0": 0, "iva": 0, "extraTaxes": { "iac": 0, "tasaAeroportuaria": 0, "agenciaDeViaje": 0 } }, "contactDetails": { "fullName": "string", "address": "string", "phoneNumber": "3123456789", "email": "string" }, "metadata": { "key0": "value0", "key1": "value1", "key2": "value2" }, "fullResponse": "v2", "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=1e26fb158957ba72cea16f9f56e3507e&mid=60000000029523491241151620414038", "trazabilityCode": "1398429", "bankId": "1022", "bankName": "BANCO UNION COLOMBIANO", "transactionReference": "aef8884f-cd4d-4b9b-9efa-ad582629e4f2" }

Request

Responses