Перейти к основному контенту

Покупка товаров и услуг без регистрации пользователя

✅ Цель сценария:

  • Пользователь не авторизован.
  • Пользователь заполняет форму с контактами (например, guest_orders).
  • Выбирает товары (можно заранее установить список).
  • Заказ оформляется на пользователя guest_user.

✅ Что вам нужно:

  • Действительный PROJECT_URL и APP_TOKEN для аутентификации с API OneEntry.
  • маркер формы заказа гостя, например guest_orders
  • список productId и количество

📌 Важно:

  • Поля формы (маркер, тип) должны соответствовать настройкам формы в административной панели.
  • Если вам нужно отправить уведомление о заказе, вы можете использовать События.
  • Мы не обрабатываем ошибки в этих примерах.
  • Вы можете обрабатывать ошибки в trycatch или в конструкции типа "await Promise.catch((error) => error)"

Сценарий

1. Импортируйте oneEntry и определите url и токен

Пример:

import { defineOneEntry } from 'oneentry';

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

2. Создание API-клиента с помощью функции defineOneEntry()

Пример:

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

3. Формируем массив с полями, необходимыми для авторизации пользователя

необходимые поля: email = "email_reg", password = "password_reg"

Результат:
[
{
"marker": "email_reg",
"value": "guest@onnentry.cloud"
},
{
"marker": "password_reg",
"value": "12345121334"
}
]

4. Вход в систему как гость с помощью AuthProvider.auth() для оформления заказа

Данные:

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

Пример:

const user = await AuthProvider.auth("email", {authData: authData});
Результат:
{
"userIdentifier": "guest@onnentry.cloud",
"authProviderIdentifier": "email",
"accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
"refreshToken": "1745494429101-...-2834edf8"
}

5. Генерация данных, которые обычно получаются из формы на фронтенде

Пример:

{
"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. Создание заказа гостя с помощью Orders.createOrder()

Пример:

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

7. Создание платежной сессии с помощью Payments.createSession()

Пример:

const payment = await Payments.createSession(order.id, 'session', false);
Результат:
{
"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. Получение одного объекта платежной сессии по идентификатору заказа с помощью Payments.getSessionByOrderId()

Пример:

const sessionByOrderId = await Payments.getSessionByOrderId(order.id);
Результат:
{
"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
}

Финальный пример

// 1. Импортируйте oneEntry и определите PROJECT_URL и APP_TOKEN
import { defineOneEntry } from 'oneentry';

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

// 2. Создание API-клиента
const { AuthProvider, Orders } = defineOneEntry(PROJECT_URL, {
token: APP_TOKEN,
});

// 3. Формируем массив с полями, необходимыми для авторизации пользователя
const authData = [
{
// маркер электронной почты формы регистрации
marker: 'email_reg',
value: 'guest@onnentry.cloud',
},
{
// маркер пароля формы регистрации
marker: 'password_reg',
value: '12345121334',
},
];

// 4. Вход в систему как гость для оформления заказа
const user = await AuthProvider.auth('email', {
authData: authData,
});

// 5. Генерируем данные, которые обычно получаются из фронтенда
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. Создание заказа гостя
const order = await Orders.createOrder('guest_orders', body);

// 7. Создание платежной сессии
const paymentSession = await Payments.createSession(
order.id,
'session',
false,
);

// 8. Обновление сессии по id
const updateSession = await Payments.updateSessionById(paymentSession.id, {
status: 'guest_completed',
paymentUrl: paymentSession.paymentUrl,
});

// 9. Получение одного объекта платежной сессии по идентификатору заказа
const sessionByOrderId = await Payments.getSessionByOrderId(order.id);
console.log(sessionByOrderId);