الدفع للطلب من قبل مستخدم مسجل

✅ هدف السيناريو:

• تفويض المستخدم المسجل
• إنشاء طلب
• إنشاء جلسة دفع

✅ ما تحتاجه:

• عنوان URL صالح للمشروع و APP_TOKEN للمصادقة مع واجهة برمجة تطبيقات OneEntry.
• مستخدم مسجل
• تخزين الطلبات المكونة مع علامة "orders"

📌 مهم:

• نحن لا نتعامل مع الأخطاء في هذه الأمثلة.
• يمكنك التعامل مع الأخطاء في trycatch أو في بناء مثل "await Promise.catch((error) => error)"

السيناريو

1. استيراد oneEntry وتعريف url و token

مثال:

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. تفويض المستخدم باستخدام AuthProvider.auth()

البيانات:

[
  {
    "marker": "email_reg",
    "value": "your-user@email.com"
  },
  {
    "marker": "password_reg",
    "value": "123456"
  }
]

مثال:

const user = await AuthProvider.auth('email', authData);

النتيجة:

{
  "userIdentifier": "your-user@email.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

4. إنشاء طلب باستخدام Orders.createOrder()

البيانات:

{
  "formIdentifier": "order",
  "paymentAccountIdentifier": "cash",
  "formData": {
    "en_US": [
      {
        "type": "string",
        "marker": "name",
        "value": "Christina Thomas"
      }
    ]
  },
  "products": [
    {
      "productId": 14,
      "quantity": 1
    }
  ]
}

مثال:

const orderData = await Orders.createOrder('orders', body);

النتيجة:

{
  "id": 89,
  "formIdentifier": "order",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "type": "string",
      "marker": "name",
      "value": "Christina Thomas"
    }
  ],
  "products": [
    {
      "productId": 14,
      "quantity": 1
    }
  ],
  "currency": "USD",
  "totalSum": 340,
  "createdDate": "2025-04-30T20:15:29.254Z"
}

إنشاء جلسة دفع باستخدام Payments.createSession()

مثال:

const sessionData = await Payments.createSession(orderData.id, 'session');

النتيجة:

{
  "id": 46,
  "createdDate": "2025-04-30T20:15:30.506Z",
  "updatedDate": "2025-04-30T20:15:30.506Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 89,
  "paymentUrl": null
}

الحصول على كائن جلسة دفع واحدة بواسطة معرف الطلب 🔐 باستخدام Payments.getSessionByOrderId()

مثال:

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

النتيجة:

{
  "id": 46,
  "createdDate": "2025-04-30T20:15:30.506Z",
  "updatedDate": "2025-04-30T20:15:30.506Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 89,
  "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, Payments } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. تفويض المستخدم باستخدام AuthProvider.auth('email', authData)
const authData = {
  authData: [
    {
      marker: 'email_reg',
      value: 'your-user@email.com',
    },
    {
      marker: 'password_reg',
      value: '123456',
    },
  ],
};
const user = await AuthProvider.auth('email', authData);

// 4. إنشاء طلب في تخزين الطلبات باستخدام Orders.createOrder()
const body = {
  formIdentifier: 'order',
  paymentAccountIdentifier: 'cash',
  formData: [
    {
      type: 'string',
      marker: 'name',
      value: 'Christina Thomas',
    },
  ],
  products: [
    {
      productId: 1,
      quantity: 1,
    },
  ],
};
const orderData = await Orders.createOrder('orders', body);

// 5. إنشاء جلسة دفع باستخدام Payments.createSession()
const sessionData = await Payments.createSession(orderData.id, 'session');

// 6. الحصول على كائن جلسة دفع واحدة بواسطة معرف الطلب 🔐
const sessionByOrderId = await Payments.getSessionByOrderId(orderData.id);
console.log(sessionByOrderId);