تقديم طلب كضيف

يقدّم طلبًا كضيف، دون تسجيل المستخدم.

ما يفعله هذا المثال:

• المستخدم لم يسجّل دخوله
• يملأ المستخدم نموذج التواصل (على سبيل المثال guest_order)
• يختار المستخدم المنتجات (يمكنك إعداد قائمة مسبقًا)
• يُنشأ الطلب دون رمز وصول. يجب أن تمتلك مجموعة المستخدمين الضيوف صلاحية إنشاء الطلبات وجلسات الدفع

المتطلبات المسبقة:

• قيمتا PROJECT_URL وAPP_TOKEN صالحتان لـ OneEntry API.
• تخزين طلبات بالعلامة guest_orders ونموذج طلب مرتبط به بالعلامة guest_order.
• صلاحية لمجموعة المستخدمين الضيوف لإنشاء الطلبات وجلسات الدفع.
• قائمة من productId وquantity

ملاحظات:

• يجب أن تطابق حقول النموذج (marker، type) إعدادات النموذج في لوحة الإدارة.
• لإرسال إشعار بشأن طلب، استخدم Events.
• تعالج الأمثلة الأخطاء بالحد الأدنى: فهي ترمي استثناءً عندما يُرجع الاستدعاء كائن خطأ.
• افتراضيًا (isShell: true) يُعيد SDK كائن خطأ بدلًا من رمي استثناء، لذا تحقق من النتيجة، مثل 'statusCode' in result. مع isShell: false يرمي استثناءً، وتعالج الأخطاء باستخدام try/catch. راجع الأخطاء.

وثائق المنصة:

• Orders

مرجع SDK:

• Orders

جربها مباشرة

شغّل هذا المثال في بيئة JS SDK التجريبية. اربط Project URL وApp Token عند الزيارة الأولى، ثم افتح:

• تقديم طلب كضيف

السيناريو

1. استورد defineOneEntry وعرّف PROJECT_URL وAPP_TOKEN

import { defineOneEntry } from 'oneentry';
import type { IOrderData } from 'oneentry';

const PROJECT_URL = 'https://your-project.oneentry.cloud';
const APP_TOKEN = 'your-app-token';

2. أنشئ عميل API

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

3. جهّز البيانات التي تأتي عادةً من نموذج الواجهة الأمامية

const guestFormData = [
  {
    marker: 'guest_name',
    type: 'string',
    value: 'John Smith',
  },
  {
    marker: 'guest_phone',
    type: 'string',
    value: '+12025550147',
  },
  {
    marker: 'guest_email',
    type: 'string',
    value: 'john@example.com',
  },
];
const productsData = [
  {
    productId: 15,
    quantity: 1,
  },
];
const body: IOrderData = {
  formIdentifier: 'guest_order',
  paymentAccountIdentifier: 'cash',
  formData: guestFormData,
  products: productsData,
};

النتيجة:

{
  "formIdentifier": "guest_order",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "marker": "guest_name",
      "type": "string",
      "value": "John Smith"
    },
    {
      "marker": "guest_phone",
      "type": "string",
      "value": "+12025550147"
    },
    {
      "marker": "guest_email",
      "type": "string",
      "value": "john@example.com"
    }
  ],
  "products": [
    {
      "productId": 15,
      "quantity": 1
    }
  ]
}

4. أنشئ طلب ضيف

const order = await Orders.createOrder('guest_orders', body);

if ('statusCode' in order) {
  throw new Error(order.message);
}

النتيجة:

{
  "id": 113,
  "formIdentifier": "guest_order",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "marker": "guest_name",
      "type": "string",
      "value": "John Smith"
    },
    {
      "marker": "guest_phone",
      "type": "string",
      "value": "+12025550147"
    },
    {
      "marker": "guest_email",
      "type": "string",
      "value": "john@example.com"
    }
  ],
  "products": [
    {
      "productId": 15,
      "quantity": 1
    }
  ],
  "currency": "USD",
  "totalSum": 400,
  "bonusApplied": 0,
  "totalDue": 400,
  "discountConfig": {
    "orderDiscounts": [],
    "productDiscounts": [],
    "coupon": null,
    "settings": {
      "allowStacking": false,
      "maxDiscountValue": null,
      "allowGiftStacking": false,
      "maxBonusPaymentPercent": null,
      "minBonusAmount": null,
      "minOrderAmountForBonus": null,
      "giftRefundPolicy": "KEEP_GIFT"
    },
    "additionalDiscountsMarkers": [],
    "totalRaw": 400,
    "totalSumWithDiscount": 400,
    "excludedGiftProductIds": [],
    "bonus": {
      "availableBalance": 0,
      "maxBonusDiscount": 0,
      "minBonusAmount": null,
      "minOrderAmountForBonus": null,
      "bonusApplied": 0
    },
    "bonusApplied": 0,
    "totalDue": 400
  },
  "statusIdentifier": "guest_upcoming",
  "statusLocalizeInfos": {
    "title": "Upcoming"
  },
  "createdDate": "2026-06-06T11:37:20.044Z"
}

5. أنشئ جلسة دفع

const paymentSession = await Payments.createSession(
  order.id,
  'session',
  false,
);

if ('statusCode' in paymentSession) {
  throw new Error(paymentSession.message);
}

console.log(paymentSession);

النتيجة:

{
  "id": 62,
  "createdDate": "2026-06-06T11:37:21.260Z",
  "updatedDate": "2026-06-06T11:37:21.260Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 113,
  "amount": null,
  "paymentUrl": null
}

6. احصل على جلسة الدفع بمعرّف الطلب باستخدام Payments.getSessionByOrderId()

const sessionByOrderId = await Payments.getSessionByOrderId(order.id);

if ('statusCode' in sessionByOrderId) {
  throw new Error(sessionByOrderId.message);
}

console.log(sessionByOrderId, paymentSession);

النتيجة:

[
  {
    "id": 62,
    "createdDate": "2026-06-06T11:37:21.260Z",
    "updatedDate": "2026-06-06T11:37:21.260Z",
    "type": "session",
    "status": "waiting",
    "paymentAccountId": 1,
    "orderId": 113,
    "amount": null,
    "paymentUrl": null
  }
]

المثال النهائي

// 1. Import defineOneEntry and define PROJECT_URL and APP_TOKEN
import { defineOneEntry } from 'oneentry';
import type { IOrderData } from 'oneentry';

const PROJECT_URL = 'https://your-project.oneentry.cloud';
const APP_TOKEN = 'your-app-token';

// 2. Create an API client
const { Orders, Payments } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. Prepare the data that usually comes from the frontend form
const guestFormData = [
  {
    marker: 'guest_name',
    type: 'string',
    value: 'John Smith',
  },
  {
    marker: 'guest_phone',
    type: 'string',
    value: '+12025550147',
  },
  {
    marker: 'guest_email',
    type: 'string',
    value: 'john@example.com',
  },
];
const productsData = [
  {
    productId: 15,
    quantity: 1,
  },
];
const body: IOrderData = {
  formIdentifier: 'guest_order',
  paymentAccountIdentifier: 'cash',
  formData: guestFormData,
  products: productsData,
};

// 4. Create a guest order
const order = await Orders.createOrder('guest_orders', body);

if ('statusCode' in order) {
  throw new Error(order.message);
}

// 5. Create a payment session
const paymentSession = await Payments.createSession(
  order.id,
  'session',
  false,
);

if ('statusCode' in paymentSession) {
  throw new Error(paymentSession.message);
}

console.log(paymentSession);

// 6. Get the payment session by order ID
const sessionByOrderId = await Payments.getSessionByOrderId(order.id);

if ('statusCode' in sessionByOrderId) {
  throw new Error(sessionByOrderId.message);
}

console.log(sessionByOrderId, paymentSession);