Crear un cliente

Es necesario crear el cliente que se suscribirá al plan. Esta acción puede realizarse tanto desde el portal de Flow como a través de la API.

Si se utiliza la API, se debe llamar al recurso /customer/create mediante un método POST, el cual devolverá el customerId del nuevo cliente. El esquema de recurso es del tipo application/x-www-form-urlencoded, que debe ser indicado en el header Content-Type.

apiKey required	string apiKey del comercio
name required	string Nombre del cliente (nombre y apellido)
email required	string Email del cliente
externalId required	string Identificador externo del cliente, es decir, el identificador con el que su sistema lo reconoce.
s required	string la firma de los parámetros efectuada con su secretKey

{

• "apiKey": "string",
• "name": "string",
• "email": "string",
• "externalId": "string",
• "s": "string"

}

Firma de parámetros

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

El servicio retorna el objeto cliente creado.

customerId	string Identificador del cliente
created	string <yyyy-mm-dd hh:mm:ss> La fecha de creación
email	string email del cliente
name	string nombre del cliente
pay_mode	string modo de pago del cliente: auto (cargo automático) manual (cobro manual)
creditCardType	string La marca de la tarjeta de crédito registrada
last4CardDigits	string Los últimos 4 dígitos de la tarjeta de crédito registrada
externalId	string El identificador del cliente en su negocio
status	string El estado del cliente: 0 Eliminado 1 Activo
registerDate	string <yyyy-mm-dd hh:mm:ss> La fecha en que el cliente registro su tarjeta de crédito.

{

• "customerId": "cus_onoolldvec",
• "created": "2017-07-21 12:33:15",
• "email": "customer@gmail.com",
• "name": "Pedro Raul Perez",
• "pay_mode": "string",
• "creditCardType": "Visa",
• "last4CardDigits": "4425",
• "externalId": "14233531-8",
• "status": "1",
• "registerDate": "2017-07-21 14:22:01"

}

Luego de crear el o los clientes a suscribir, se puede Registrar tarjeta del cliente o Suscribir cliente a un plan.