Dispersa a cuentas bancarias

07 marzo 2024

Reparte tu dinero a las cuentas bancarias de tus clientes

El proceso para dispersar pagos con transferencia consiste en entregar dinero a las cuentas de tus clientes. En otras palabras, si dispones de la información bancaria de estos, puedes usar tu cuenta de dispersión de Kushki y por medio de transferencia enviar el dinero a sus cuentas, usando la lógica que prefieras.

Ideal para:

Pago a proveedores o vendedores
Marketplaces
Aplicaciones de delivery

Detalles de operación

El proceso de dispersión en Chile se realiza a través del siguiente flujo: Kushki > Banco > Usuario.

Parámetro	Detalle
Monto mínimo por transacción	1 CLP
Monto máximo por transacción	7,000,000 CLP
Monto máximo por beneficiario	80,000,000 CLP por día
Horario de procesamiento	24/7
Días de procesamiento	Lunes a Domingo
Tiempo en aprobarse una transacción	Inmediato (mismo banco y otros bancos)

Flujo

El flujo que integrarás es el siguiente:

Flujo transfer out

Aquí aprenderás cómo integrar las dispersiones de dinero con transferencia.

1. Obtén el listado de bancos asociados

El primer paso es consultar el listado de bancos disponibles para realizar la transferencia. Para ello, debes consumir este endpoint, el cual, te mostrará las instituciones bancarias disponibles para poder realizar la transacción.

Javascript
Python
PHP

var request = require('request');
var bankList = [];
var options = {
  'method': 'GET',
  'url': 'https://api-uat.kushkipagos.com/payouts/transfer/v1/bankList', // Test environment
  'headers': {
    'Public-Merchant-Id': '' // Replace with your Public Key
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
  bankList = response.body;
  // Submit your code to filter the bank you need and send its id in token request
});

import requests

url = "https://api-uat.kushkipagos.com/payouts/transfer/v1/bankList" // Test environment
bankList = []

payload = {}
headers = {
  'Public-Merchant-Id': ''  // Replace with your Public Key
}

response = requests.request("GET", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
bankList = response.text

// Submit your code to filter the bank you need and send its id in token request

$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://api-uat.kushkipagos.com/payouts/transfer/v1/bankList'); // Test environment
$request->setRequestMethod('GET');
$request->setOptions(array());
$request->setHeaders(array(
  'Public-Merchant-Id' => '' // Replace with your Public Key
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
bankList = $response->getBody();
// Submit your code to filter the bank you need and send its id in token request

Como respuesta a esta llamada, recibirás el nombre (name) y el código (code) de los bancos disponibles. Este último debe ser enviado en la solicitud del token de transfer out.

2. Tokeniza la información

Una vez obtenido el código del banco al que está relacionada la cuenta bancaria para realizar la transferencia, deberás realizar la petición del token utilizando nuestro endpoint de solicitud de token de transferencia.

Javascript
Python
PHP

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api-uat.kushkipagos.com/payouts/transfer/v1/tokens', // Test environment
  'headers': {
    'Public-Merchant-Id': '', // Replace with you Public Key
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "name":"John Doe"
      "documentNumber":"19885521",
      "accountNumber":"06",
      "accountType":"CA",
      "bankId":"001",
      "totalAmount":100,
      "documentType":"RUT",
      "currency":"CLP",
      "paymentDescription": "A short description of the payment"
    })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
  // Submit your code to send the token you received to the next request
});

import requests

url = "https://api-uat.kushkipagos.com/payouts/transfer/v1/tokens" // Test enviroment 

payload = "{\n  \"name\": \"John Doe\",\n \"documentNumber\": \"19885521\",\n  \"accountNumber\": \"06\",\n  \"accountType\": \"CA\",\n  \"bankId\": \"001\",\n  \"totalAmount\": 100,\n  \"documentType\": \"RUT\",\n  \"currency\": \"CLP\",\n  \"paymentDescription\": \"A short description of the payment\" \n}"
headers = {
  'Public-Merchant-Id': '', // Replace with your Private Key
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

// Submit your code to send the token received to the next request

$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://api-uat.kushkipagos.com/payouts/transfer/v1/tokens'); // Test environment
$request->setRequestMethod('POST');
$body = new http\Message\Body;
$body->append('{
  "name": "John Doe"
  "documentNumber": "19885521",
  "accountNumber": "06",
  "accountType": "CA",
  "bankId": "001",
  "totalAmount": 100,
  "documentType": "RUT",
  "currency": "CLP"
  "paymentDescription": "A short description of the payment"
}');
$request->setBody($body);
$request->setOptions(array());
$request->setHeaders(array(
  'Public-Merchant-Id' => '', // Replace with your Public Key
  'Content-Type' => 'application/json'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();
// Submit your code to send the token received to the next request

3. Inicializa la transacción

En esta etapa, debes recibir el token obtenido e iniciar el proceso de dispersión con Kushki. Por lo tanto, necesitarás realizar una llamada a nuestro endpoint de inicialización para procesar el pago.

Javascript
Python
PHP

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api-uat.kushkipagos.com/payouts/transfer/v1/init', // Test environment
  'headers': {
    'Private-Merchant-Id': '', // Replace with your Private Key
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "amount":{
    "subtotalIva":0,
        "subtotalIva0":100,
        "iva":0
    },
    "token":"53de1cb6bbb54011a0a98053d48677e0" // Replace with the token you received
    })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

import requests

url = "https://api-uat.kushkipagos.com/payouts/transfer/v1/init" // Test environment

payload = "{\n  \"amount\": {\n    \"subtotalIva\": 0,\n    \"subtotalIva0\": 100,\n    \"iva\": 0\n  },\n  \"token\": \"53de1cb6bbb54011a0a98053d48677e0\"\n}" // Replace with the token you received
headers = {
  'Private-Merchant-Id': '', // Replace with your Private Key
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))

$client = new http\Client;
$request = new http\Client\Request;
$request->setRequestUrl('https://api-uat.kushkipagos.com/payouts/transfer/v1/init'); // Test environment
$request->setRequestMethod('POST');
$body = new http\Message\Body;
$body->append('{
  "amount": {
    "subtotalIva": 0,
    "subtotalIva0": 100,
    "iva": 0
  },
  "token": "53de1cb6bbb54011a0a98053d48677e0" // Replace with the token you received
}');
$request->setBody($body);
$request->setOptions(array());
$request->setHeaders(array(
  'Private-Merchant-Id' => '', // Replace with your Private Key
  'Content-Type' => 'application/json'
));
$client->enqueue($request)->send();
$response = $client->getResponse();
echo $response->getBody();

La respuesta proporciona, un número de ticket e indica el estado de la transacción.

4. Consulta el estado de la transacción (opcional)

Ahora que la transferencia está próxima a procesarse, puedes conocer el estado de la transacción utilizando webhooks o consultando manualmente utilizando nuestra API

Webhook

El estado de la transacción se notifica automáticamente una vez el dinero ha sido liquidado.

API

Puedes utilizar en nuestra API, el endpoint Get Status para consultar manualmente el estado de una transacción específica.

5. Prueba tu integración

Existen números de identificación de prueba que puedes utilizar en el ambiente UAT para asegurarte de que tu integración está lista.

Transacción aprobada

Número de cuenta: 1200000000
Número de identificación: 19.998.005-K
Tipo de identificación: RUT
Tipo de cuenta: CA, CC o CV

Transacción cancelada

Número de cuenta: 1200000000
Número de identificación: 19.998.005-4
Tipo de identificación: RUT
Tipo de cuenta: CA, CC o CV

6. Prepara tu certificación

Toma en consideración las siguientes pautas para aprobar la certificación técnica (requerida para obtener credenciales productivas):

Mostrar mensajes en pantalla de acuerdo con las respuestas de Kushki.
Guardar y registrar todas las respuestas de Kushki (requeridas en caso de necesitar soporte).
Si se reciben notificaciones por webhook correctamente, responder a la solicitud con un status 200.
Asegurarse que en el cuerpo de la petición se envíen todos los campos requeridos en la referencia API.

Acepta webhooks

Maneja eventos pospago de la manera correcta.