Crear una tienda en Rocketfy

Con este método podras crear una tienda dentro de Rocketfy si es que tienes múltiples clientes y deseas que cada uno de tus clientes sea independiente.

Crear una nueva tienda

POST https://api.rocketfy.co/api/public/createAccount

Headers

Name	Type	Description
Authorization	string	Token que recibes del método de autenticación inicial en Primeros pasos y debe enviarse en el siguiente formato: Bearer MI_TOKEN_DE_ACCESO

Request Body

Name	Type	Description
partnerID	string	Identificador que te proveeremos según el contrato de integración que tengas con Rocketfy y su área comercial.
customer_domain	string	Dominio de la tienda que quieres crear (Este valor es el dominio o URL que representa tu cliente en tu plataforma)
address_shop	string	Dirección de la tienda desde donde se despacharán posteriormente sus envíos. Ejemplo: "Carrera 10 # 15 - 20"
origin_departament	string	Departamento de la tienda desde donde se despacharán sus envíos. Ejemplo: "Antioquia"
origin_city	string	Ciudad de la tienda desde donde se despacharán sus envíos. Ejemplo: "Medellin"
phone	string	Teléfono celular del dueño de la tienda, este valor es un valor númerico, regularmente de 10 dígitos. Ejemplo: 310XXXXXXX
customer_name	string	Nombre de la persona encargada de la tienda o propietaria. Ejemplo: "Juan"
name	string	Nombre personalizado de la tienda. Ejemplo: "Mi tienda Rocketfy"
email	string	Correo electrónico de la tienda. Ejemplo: "[e-mail]"

200 Respuesta de creación de la nueva tienda correctamente.

{
  "message": {
    "success": true
  },
  "data": {
    "email": "[e-mail]",
    "customerID": "testpublicapi_1325176081",
    "customerDomain": "https://domainShop.co",
    "redirectUrl": "http://test.rocketfy.co/login?eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXJ0bmVyIjoicGFydG5lcklEIiwiSUQiOiJ0ZXN0cHVibGljYXBpXzEzMjUxNzYwODEiLCJpbnRlZ3JhdGlvbiI6dHJ1ZSwic3BhcnNlciI6ImYzNzliMTYzYzIwOTQ0YzcyZjVjZmEyZDE2ZDk2NDE4MWE4MDg0ZmE2MDViYWU4NWI2ZjE1NzMwM2ZhMjFlMjJhMmVjYTYyMDZmNTAzY2I0YjJiZDM3NzJkMjczYWE1MTNmZWIzMzEzY2RhMTIyNzAwMDEwNTM2YTcwZGU2MDM0In0.Vp1PS2CTU1lGJDsD3hEJbbK0Wrboq9oj107WPNlptPo"
  }
}

404 Respuesta de que ya existe el usuario o hubo un fallo al intentarlo.

{
  "message": {
    "success": false
  },
  "err": "Business Logic"
}

Ejemplo para crear una nueva tienda en Rocketfy

Con este ejemplo puedes tener más claridad de cómo envíar la petición y cómo se componen sus parámetros. Nota: las ciudades y departamentos se pueden consultar con el método

{
    "email": "[e-mail]",
    "name": "SomeShop",
    "customer_name" : "SomeShop",
    "country" : "COL",
    "phone" : "3158739953",
    "terms" : true,
    "origin_city":"Cali",
    "origin_departament": "Valle del cauca",
    "address_shop":"calle 14 oeste # 4 - 46",
    "customer_domain":"https://SomeShop.co",
    "partnerID":"someshop_94890458"
}

Verificar la firma del token de redirectUrl

El redirectUrl es un JWT con validez de 30 minutos firmado mediante llave asimétrica. Para validarla y poder hacer uso del token es necesario de una llave pública suministrada por nosotros.

Este es un ejemplo de cómo pueden validar y hacer uso del token para obtener la URL de re-dirección final. Es importante para poder validar el token, además de la clave pública, enviarle los parámetros complementarios que están en la variable verifyOption.

const publicKey = fs.readFileSync(`${__dirname}/keys/public_key.pem`, "utf8");

const iss = "Rocketfy";
const sub = "[e-mail]";
const aud = "https://www.rocketfy.co/";
const exp = "30m";

const verifyOption = {
  issuer: iss,
  subject: sub,
  audience: aud,
  maxAge: exp,
  algorithm: "RS256"
}

const { url } = jwt.verify(req.body.token, publicKey, verifyOption);
console.log('verified', url)