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.

🇨🇴 Colombia — Flujo Bre-B (pagos con QR en tiempo real)

Para pagar con Bre-B en lugar de la redirección tradicional a PSE, envía el objeto opcional processor: "processor": { "name": "Bre-B Credibanco Processor", "flowType": "QR" }. Copia ambos valores exactamente como los devuelve Consultar la configuración de Transfer In (GET /transfer/v1/config). Cuando envías processor, solo amount y currency siguen siendo requeridos: callbackUrl, userType, documentType, documentNumber, paymentDescription y email pasan a ser opcionales, y bankId no aplica.

No necesitas llamar antes a Consultar lista de bancos: el cliente autoriza el pago escaneando un QR en su app bancaria en lugar de elegir un banco.

Bre-B requiere el procesador habilitado en tu MID; contacta a tu ejecutivo de cuenta para activarlo. La integración tradicional con PSE 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.

Migración desde el contrato de la BETA

Si integraste Bre-B durante la BETA con el objeto flow ({ "flow": { "processorName": "BRE-B", "type": "QR" } }), reemplázalo por el objeto processor que se muestra arriba. El objeto flow queda reemplazado con este release.

curl --location 'https://api-uat.kushkipagos.com/transfer/v1/tokens' \ --header 'Public-Merchant-Id: 20432ef8ccd94r51b36e5b738a81f511' \ --header 'Content-Type: application/json' \ --data-raw '{ "bankId": "1022", "amount": { "subtotalIva": 100000, "subtotalIva0": 0, "iva": 10000, "extraTaxes": { "tasaAeroportuaria": 0, "agenciaDeViajes": 0, "iac": 0 } }, "callbackUrl": "https://kushki.com", "userType": "1", "documentType": "NIT", "documentNumber": "1716458334", "paymentDescription": "Description of the payment.", "email": "user@example.com", "currency": "COP" }'

Expiración del token

Request