i18n: Lingo (docs)

apps/docs/content/docs/ar/payments/accept-payments/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "قبول المدفوعات",
-  "pages": ["payment-button", "verification-tools", "indexing"],
+  "pages": ["payment-button", "verification-tools", "indexing", "pay-sh"],
   "defaultOpen": false
 }

apps/docs/content/docs/ar/payments/accept-payments/pay-sh.mdx

@@ -0,0 +1,73 @@
+---
+title: مع Pay.sh
+description: اقبل المدفوعات باستخدام Pay.sh.
+---
+
+يمكنك قبول المدفوعات على طلبات API عبر Pay.sh من خلال إعداد خادم Pay. ثبّت Pay
+باستخدام:
+
+```bash
+brew install pay
+```
+
+أو
+
+```bash
+npm install -g @solana/pay
+```
+
+تحقق من التثبيت باستخدام:
+
+```bash
+pay --version
+```
+
+ستقوم سلسلة الأدوات بإعداد عنوانك تلقائيًا. شغّل الأمر التالي لإعداد محفظتك
+وتعبئتها:
+
+```bash
+pay setup
+```
+
+## إعداد الخادم التجريبي
+
+يمكنك البدء في قبول المدفوعات عن طريق تشغيل الخادم الخاص بك. يمكنك مشاهدة الخادم
+التجريبي في العمل باستخدام:
+
+```bash
+pay server demo
+```
+
+يؤدي هذا وظيفتين: يشغّل خادم Pay مباشرةً يمكنك الاستعلام عنه عبر طلب HTTP،
+ويُنشئ ملف `pay-demo.yml` في دليلك الحالي.
+
+يتم تكوين جميع مسارات API عبر إعداد YAML الخاص بـ `endpoints`. لقبول المدفوعات،
+يجب عليك إضافة سمة `metering:`. وقد تم تنفيذ مسار `/api/v1/reports/usage` كمثال
+توضيحي لك:
+
+```yaml
+endpoints:
+  - method: GET
+    path: "api/v1/reports/usage"
+    resource: "reports"
+    description: "Usage report — flat fee, no splits."
+    metering:
+      dimensions:
+        - direction: usage
+          unit: requests
+          scale: 1
+          tiers:
+            - price_usd: 0.01
+```
+
+يمكنك اختبار عمل المدفوعات عن طريق تشغيل الأمر التالي كعميل في محطة طرفية أخرى:
+
+```bash
+pay --sandbox curl http://127.0.0.1:1402/api/v1/reports/usage
+```
+
+يمكنك الاطلاع على مزيد من المعلومات حول كيفية تحديد الأسعار في
+[وثائق Pay.sh - البناء مع Pay > التسعير](https://pay.sh/docs/building-with-pay/pricing)
+
+تعرف على المزيد حول إعداد Pay.sh في بيئة الإنتاج في
+[وثائق تكوين Pay.sh](https://pay.sh/docs/toolchain/configuration).

apps/docs/content/docs/ar/payments/agentic-payments.mdx

@@ -32,29 +32,54 @@ description:
 التطبيقات تحدي `402 Payment Required` من نوع MPP أو x402، يطلب `pay` من محفظتك
 المحلية الموافقة على التوقيع.
 
+يمكنك تثبيت Pay باستخدام:
+
+```bash
+brew install pay
+```
+
+أو
+
+```bash
+npm install -g @solana/pay
+```
+
+تحقق من التثبيت باستخدام:
+
+```bash
+pay --version
+```
+
+ستقوم سلسلة الأدوات بإعداد عنوانك تلقائيًا. شغّل الأوامر التالية لإعداد محفظتك
+وتعبئتها:
+
+```bash
+pay setup
+```
+
 ## بروتوكول x402
 
-تحتاج المدفوعات الوكيلية إلى طريقة للعملاء والخوادم للتفاوض على شروط الدفع عبر
-البنية التحتية القياسية للويب دون تعطيل واجهات الويب التقليدية. لا تزال مساحة
-الدفعات الصغيرة ناشئة ومن المحتمل أن تظهر أدوات ومعايير جديدة مع تطور المجال.
-ومع ذلك، برز [بروتوكول x402](https://www.x402.org/) كمعيار مبكر مع دعم قوي من
-النظام البيئي. يستخدم x402
-[رمز الحالة 402 "الدفع مطلوب" في HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/402) -
-وهو معيار منذ HTTP/1.1 أصبح عمليًا فقط مع التسوية عبر البلوكشين.
+تحتاج المدفوعات الذكية إلى وسيلة تتيح للعملاء والخوادم التفاوض على شروط الدفع
+عبر البنية التحتية للويب القياسية دون الإخلال بواجهات الويب التقليدية. لا يزال
+مجال المدفوعات الصغيرة في مراحله الأولى، وسيشهد على الأرجح ظهور أدوات ومعايير
+جديدة مع تطوره. غير أن [بروتوكول x402](https://www.x402.org/) قد برز كمعيار مبكر
+يحظى بدعم قوي من النظام البيئي. يستخدم x402 رمز الحالة
+[HTTP 402 "Payment Required"](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/402)—وهو
+معيار منذ HTTP/1.1 لم يصبح عمليًا إلا مع تسوية البلوك تشين.
 
-### كيف يعمل
+### آلية العمل
 
-يقوم العميل بإجراء طلب، ويتلقى رمز 402 مع شروط الدفع، ثم يعيد المحاولة بدفعة
-موقعة. يفوض الخادم التحقق والتسوية إلى ميسّر، وهو وسيط اختياري يتعامل مع إرسال
-المعاملة على السلسلة. بمجرد أن يؤكد الميسّر التسوية، يعيد الخادم المحتوى
-المطلوب. يتيح هذا الفصل لمزودي واجهات برمجة التطبيقات قبول المدفوعات دون إدارة
-أي بنية تحتية على السلسلة بشكل مباشر.
+يُرسل العميل طلبًا، فيتلقى استجابة 402 تتضمن شروط الدفع، ثم يُعيد المحاولة
+مرفقًا بدفعة موقّعة. يفوّض الخادم عملية التحقق والتسوية إلى وسيط تسهيل—وهو وسيط
+اختياري يتولى إرسال المعاملات على السلسلة. وبمجرد أن يؤكد الوسيط اكتمال التسوية،
+يُعيد الخادم المحتوى المطلوب. يتيح هذا الفصل لمزودي واجهات برمجة التطبيقات قبول
+المدفوعات دون الحاجة إلى إدارة أي بنية تحتية على السلسلة بشكل مباشر.
 
 ![مخطط تدفق x402](/assets/guides/x402/x402-flow-solana.png)
 
-البروتوكول عديم الحالة (لا جلسات أو مفاتيح API)، ويعمل مع البنية التحتية
-القياسية لـ HTTP، ويدعم أي رمز SPL يقبله الخادم. إليك مقتطف حول كيفية إعداد خادم
-Express باستخدام وسيط x402:
+البروتوكول عديم الحالة (لا جلسات ولا مفاتيح API)، ويعمل مع البنية التحتية
+القياسية لـ HTTP، ويدعم أي رمز SPL يقبله الخادم. إليك مقتطفًا يوضح كيفية إعداد
+خادم Express باستخدام وسيط x402:
 
 ```ts
 app.use(
@@ -89,28 +114,28 @@ app.get("/costly-data", (req, res) => {
 });
 ```
 
-لمعرفة المزيد عن x402، راجع أدلتنا:
+لمعرفة المزيد حول x402، اطّلع على أدلتنا:
 
 <Cards>
   <Card
     title="مقدمة إلى x402"
     href="/developers/guides/getstarted/intro-to-x402"
-    description="أساسيات البروتوكول وخيارات SDK لبناء واجهات برمجية ممكّنة للدفع."
+    description="أساسيات البروتوكول وخيارات SDK لبناء واجهات برمجة تطبيقات تدعم الدفع."
   />
   <Card
-    title="البناء باستخدام Kora"
+    title="البناء مع Kora"
     href="/developers/guides/getstarted/build-a-x402-facilitator"
-    description="تطبيق مدفوعات x402 بدون رسوم غاز باستخدام البنية التحتية للتوقيع من Kora."
+    description="تنفيذ مدفوعات x402 بدون رسوم غاز باستخدام بنية التوقيع الخاصة بـ Kora."
   />
 </Cards>
 
 ### أدوات x402
 
-| SDK                                                             | الوصف                            |
-| --------------------------------------------------------------- | -------------------------------- |
-| [Corbits](https://corbits.dev/)                                 | تطبيق x402 مصمم أولاً لسولانا    |
-| [MCPay.tech](https://mcpay.tech/)                               | الدفع مقابل كل طلب لخوادم MCP    |
-| [PayAI](https://payai.network/)                                 | ميسّر x402 مع دعم سولانا         |
-| [x402 GitHub](https://github.com/coinbase/x402)                 | التطبيق المرجعي                  |
-| [ACK](https://github.com/agentcommercekit/ack)                  | مجموعة أدوات التجارة عبر الوكلاء |
-| [A2A x402](https://github.com/google-agentic-commerce/a2a-x402) | مدفوعات Google من وكيل إلى وكيل  |
+| SDK                                                             | الوصف                              |
+| --------------------------------------------------------------- | ---------------------------------- |
+| [Corbits](https://corbits.dev/)                                 | تنفيذ x402 بأولوية سولانا          |
+| [MCPay.tech](https://mcpay.tech/)                               | الدفع لكل طلب لخوادم MCP           |
+| [PayAI](https://payai.network/)                                 | ميسّر x402 مع دعم سولانا           |
+| [x402 GitHub](https://github.com/coinbase/x402)                 | التنفيذ المرجعي                    |
+| [ACK](https://github.com/agentcommercekit/ack)                  | مجموعة أدوات تجارة الوكلاء         |
+| [A2A x402](https://github.com/google-agentic-commerce/a2a-x402) | مدفوعات من وكيل إلى وكيل من Google |

apps/docs/content/docs/ar/payments/subscriptions/meta.json

@@ -6,7 +6,8 @@
     "fixed-delegation",
     "recurring-delegation",
     "subscription-plan",
-    "close-subscription-authority"
+    "close-subscription-authority",
+    "pay-sh"
   ],
   "defaultOpen": false
 }

apps/docs/content/docs/ar/payments/subscriptions/pay-sh.mdx

@@ -0,0 +1,121 @@
+---
+title: مع Pay.sh
+description: أنشئ اشتراكات باستخدام Pay.sh.
+---
+
+يمكنك إعداد الاشتراكات عبر Pay.sh من خلال تهيئة عميل Pay على جهازك أو إعداد خادم
+Pay. قم بتثبيت Pay باستخدام:
+
+```bash
+brew install pay
+```
+
+أو
+
+```bash
+npm install -g @solana/pay
+```
+
+تحقق من التثبيت باستخدام:
+
+```bash
+pay --version
+```
+
+ستقوم سلسلة الأدوات بإعداد عنوانك تلقائيًا. شغّل الأمر التالي لإعداد محفظتك
+وتعبئتها:
+
+```bash
+pay setup
+```
+
+## الاشتراكات كعميل
+
+يشترك المستخدمون في نقاط نهاية API المحمية بالاشتراك عن طريق استدعاء pay
+بالطريقة المعتادة. يقع على عاتق الـ API إرسال تفاصيل الاشتراك في استجابة
+`402 Status` الأولية. يتولى Pay إدارة الاشتراك تلقائيًا، بما في ذلك استدعاء
+التعليمات على برنامج سولانا SPL Subscriptions.
+
+يمكن للمستخدمين إدارة اشتراكاتهم باستخدام الأوامر التالية:
+
+```bash
+pay subscriptions                       # default: list + show available subcommands
+pay subscriptions list                  # same, scriptable
+pay subscriptions list --network mainnet
+pay subscriptions list --json
+```
+
+يمكنك الاطلاع على مزيد من المعلومات حول إدارة اشتراكاتك كمستخدم في
+[Pay.sh > استخدام Pay > وثائق إدارة الاشتراكات](https://pay.sh/docs/using-pay/subscriptions).
+
+## إدارة الاشتراكات كمزوّد (عرض توضيحي)
+
+تتيح خوادم Pay تهيئة المشتركين واشتراكاتهم لكل نقطة نهاية. فيما يلي مثال على
+نقطة نهاية تستخدم pay يمكنك تجربته مع مشروعك:
+
+```yaml
+# monthly.yml
+name: Subscriptions Example
+subdomain: subscriptions-example
+title: "Subscription Example"
+description: "Demo Subscriptions"
+category: ai_ml
+version: v1
+routing:
+  type: respond
+operator:
+  currencies:
+    usd: ["USDC", "USDT", "CASH"]
+  network: "localnet"
+  fee_payer: true
+  challenge_binding_secret: d858d9104afd728f58a1f73d806dd75d8f32ebd37c9707145816b490e8631d41
+  # insert your own challenge_binding_secret here. use `openssl rand -hex 32`
+
+endpoints:
+  - method: GET
+    path: "api/v1/pro/feed"
+    resource: "pro-feed"
+    description: "Pro feed — monthly subscription, 30-day billing period."
+    subscription:
+      period: "30d"
+      price_usd: 9.99
+      currency: USDC
+      plan_id_numeric: 1
+```
+
+يتعامل Pay مع الاشتراكات باستخدام السمة `subscription:` في مواصفات `endpoints`
+بصيغة YAML. وهذا يختلف عن السمة `metering:` المستخدمة لنقاط نهاية الدفع لكل
+استخدام.
+
+يؤدي تشغيل الخادم في المثال أعلاه إلى إنشاء نقطة نهاية تُسمى `api/v1/pro/feed`
+تتطلب من المستخدم إجراء مدفوعات دورية بقيمة 9.99 USDC كل 30 يومًا.
+
+يمكنك تجربة ذلك بتشغيل الأمر التالي:
+
+```bash
+pay server start monthly.yml
+```
+
+سيطالبك تشغيل هذا الأمر بإنشاء خطة. يؤدي ذلك إلى إنشاء الخطة وتحديث ملف yml. إذا
+كنت ستستخدمه مجددًا، احتفظ بعنوان الخطة واستخدمه في إعداداتك أثناء إجراء
+التغييرات.
+
+يمكنك اختبار أن الاشتراكات تعمل بشكل صحيح عن طريق تشغيل الأوامر التالية كعميل في
+طرفية أخرى:
+
+```bash
+# First call — activates the subscription, $9.99 USDC charge settles.
+pay --sandbox curl http://127.0.0.1:1402/api/v1/pro/feed
+
+# Same call within 30 days — no payment prompt, just the response.
+pay --sandbox curl http://127.0.0.1:1402/api/v1/pro/feed
+```
+
+يجب أن ترى حالة OK كاستجابة على النحو التالي:
+
+```json
+{ "status": "ok" }
+```
+
+يمكنك معرفة المزيد حول إدارة الاشتراكات على خادم Pay عبر
+[Pay.sh > Building with Pay > Subscriptions > YAML Specification docs](https://pay.sh/docs/building-with-pay/subscriptions/yaml-specification).

apps/docs/content/docs/de/payments/accept-payments/meta.json

@@ -1,5 +1,5 @@
 {
   "title": "Zahlungen akzeptieren",
-  "pages": ["payment-button", "verification-tools", "indexing"],
+  "pages": ["payment-button", "verification-tools", "indexing", "pay-sh"],
   "defaultOpen": false
 }