Primeros pasos

Antes de interactuar con la API REST de Flow debes tener una cuenta creada y tener tus credenciales de integración, para ello debes completar el registro en flow.cl donde obtendrás tus credenciales productivas.

Para obtener tus credenciales de sandbox que te permitirán trabajar en un ambiente de pruebas controlado, debes registrarte en la url de sandbox de Flow sandbox.flow.cl.

Consejo

Te recomendamos hacer las pruebas primero en nuestro ambiente de sandbox.

Una vez completado el registro de tu cuenta o si ya tienes una en cualquiera de los dos ambientes, ve a la sección mis datos y obtén tus credenciales en la pestaña de integraciones donde podrás acceder a tu API Key y Secret key que te permitirán interactuar con nuestra api en las siguientes urls.

Ambiente	url
Sandbox	https://sandbox.flow.cl/api
Producción	https://www.flow.cl/api

Firmado de parámetros

Todos los parámetros que se envíen en el body o en query params a cualquier endpoint de la API deben ser firmados con su secret key, esto lo logras agregando un parámetro "s" con el valor de la firma que se obtiene bajo el siguiente procesos

1. Ordenar los parámetros de forma alfabética ascendente en base al nombre del parámetro.
2. Una vez ordenados, se deben concatenar en un string los parámetros de la siguiente forma: Nombre_del_parametro valor nombre_del_parametro valor.

Ejemplo, si sus parámetros son:

• "apiKey" = "XXXX-XXXX-XXXX"
• "currency" = "CLP"
• "amount" = 5000 El string ordenado para firmar debería ser:

"amount5000apiKeyXXXX-XXXX-XXXXcurrencyCLP"

Ejemplos de firmado de parámetros en diferentes lenguajes de programación

PHP

$secretKey = 'my secret'
$params = array(
'apiKey' => '1F90971E-8276-4715-97FF-2BLG5030EE3B',
'token' => 'AJ089FF5467367'
);
$keys = array_keys($params);
sort($keys);
$toSign = '';
foreach($keys as $key) {
$toSign .= $key . $params[$key];
};
$signature = hash_hmac('sha256', $toSign , $secretKey);

NodeJS

const {createHmac} = require("node:crypto")

const secretKey = "my secret";
const params = {
  apiKey: "1F90971E-8276-4715-97FF-2BLG5030EE3B",
  token: "AJ089FF5467367",
};
const keys = Object.keys(params);
keys.sort();
let toSign = "";
for (let i = 0; i < keys.length; i++) {
  let key = keys[i];
  toSign += key + params[key];
}
const signature = createHmac("sha256",secretKey).update(toSign).digest("hex")

Phyton

import hmac
import hashlib

secret_key
params = {
'apiKey': '1F90971E-8276-4715-97FF-2BLG5030EE3B',
'token': 'AJ089FF5467367'
}
keys = list(params.keys())
keys.sort()
to_sign = ''
for key in keys:
    to_sign += key + params[key]
    
signature = hmac.new(secret_key.encode(), to_sign.encode(), hashlib.sha256).hexdigest()

Productos de integración de flow

📄️ Pagos Ecommerce

📄️ Planes de suscripción