Saltar al contenido principal

Compra de bienes y servicios sin registro de usuario

✅ Propósito del escenario:

  • El usuario no está autorizado.
  • El usuario completa un formulario con contactos (por ejemplo, guest_orders).
  • Selecciona productos (se puede preestablecer una lista).
  • El pedido se realiza para el usuario guest_user.

✅ Lo que necesitas:

  • Una PROJECT_URL y APP_TOKEN válidos para la autenticación con la API de OneEntry.
  • marcador del formulario de pedido de invitados, por ejemplo guest_orders
  • lista productId y cantidad

📌 Importante:

  • Los campos del formulario (marcador, tipo) deben coincidir con la configuración del formulario en el panel de administración.
  • Si necesitas enviar una notificación sobre un pedido, puedes usar Eventos.
  • No manejamos errores en estos ejemplos.
  • Puedes manejar errores en trycatch o en una construcción como "await Promise.catch((error) => error)"

Escenario​

1. Importar oneEntry y definir url y token​

Ejemplo:

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. Crear un cliente API con la función defineOneEntry()​

Ejemplo:

const { AuthProvider, Orders, Payments, Forms } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. Formamos un array con los campos requeridos para la autorización del usuario​

campos requeridos: email = "email_reg", password = "password_reg"

Resultado:
[
  {
    "marker": "email_reg",
    "value": "guest@onnentry.cloud"
  },
  {
    "marker": "password_reg",
    "value": "12345121334"
  }
]

4. Iniciar sesión como usuario invitado con AuthProvider.auth() para realizar un pedido​

Datos:

[
  {
    "marker": "email_reg",
    "value": "guest@onnentry.cloud"
  },
  {
    "marker": "password_reg",
    "value": "12345121334"
  }
]

Ejemplo:

const user = await AuthProvider.auth("email", {authData: authData});
Resultado:
{
  "userIdentifier": "guest@onnentry.cloud",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

5. Generar datos que normalmente se reciben del formulario del frontend​

Ejemplo:

{
  "formIdentifier": "guest_order",
  "paymentAccountIdentifier": "cash",
  "formData": {
    "en_US": [
      {
        "marker": "guest_name",
        "type": "string",
        "value": "Christina Thomas"
      },
      {
        "marker": "guest_phone",
        "type": "string",
        "value": "+18005000500"
      },
      {
        "marker": "guest_email",
        "type": "string",
        "value": "guest@yourmail.com"
      }
    ]
  },
  "products": [
    {
      "productId": 10,
      "quantity": 1
    }
  ]
}

6. Crear un pedido de invitado con Orders.createOrder()​

Ejemplo:

const orderData = await Orders.createOrder("guest_orders", body);

7. Creación de sesión de pago con Payments.createSession()​

Ejemplo:

const payment = await Payments.createSession(order.id, 'session', false);
Resultado:
{
  "id": 47,
  "createdDate": "2025-04-30T21:47:45.344Z",
  "updatedDate": "2025-04-30T21:47:45.344Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 90,
  "paymentUrl": null
}

8. Obtener un objeto de sesión de pago por identificador de pedido con Payments.getSessionByOrderId()​

Ejemplo:

const sessionByOrderId = await Payments.getSessionByOrderId(order.id);
Resultado:
{
  "id": 47,
  "createdDate": "2025-04-30T21:47:45.344Z",
  "updatedDate": "2025-04-30T21:47:45.344Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 90,
  "paymentUrl": null
}

Ejemplo final​

// 1. Importar oneEntry y definir PROJECT_URL y APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

// 2. Crear un cliente API
const { AuthProvider, Orders } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. Formamos un array con los campos requeridos para la autorización del usuario
const authData = [
  {
    // marcador de email del formulario de registro
    marker: 'email_reg',
    value: 'guest@onnentry.cloud',
  },
  {
    // marcador de contraseña del formulario de registro
    marker: 'password_reg',
    value: '12345121334',
  },
];

// 4. Iniciar sesión como usuario invitado para realizar un pedido
const user = await AuthProvider.auth('email', {
  authData: authData,
});

// 5. generamos datos que normalmente se reciben del frontend
const guestFormData = [
  {
    marker: 'guest_name',
    type: 'string',
    value: 'Christina Thomas',
  },
  {
    marker: 'guest_phone',
    type: 'string',
    value: '+18005000500',
  },
  {
    marker: 'guest_email',
    type: 'string',
    value: 'guest@yourmail.com',
  },
];
const productsData = [
  {
    productId: 1,
    quantity: 1,
  },
];
const body: IOrderData = {
  formIdentifier: 'guest_order',
  // paymentAccountIdentifier: cash | stripe
  paymentAccountIdentifier: 'cash',
  formData: guestFormData,
  products: productsData,
};

// 6. Crear un pedido de invitado
const order = await Orders.createOrder('guest_orders', body);

// 7. Creación de sesión de pago
const paymentSession = await Payments.createSession(
  order.id,
  'session',
  false,
);

// 8. Actualizar sesión por id
const updateSession = await Payments.updateSessionById(paymentSession.id, {
  status: 'guest_completed',
  paymentUrl: paymentSession.paymentUrl,
});

// 9. Obtener un objeto de sesión de pago por identificador de pedido
const sessionByOrderId = await Payments.getSessionByOrderId(order.id);
console.log(sessionByOrderId);