Skip to content

Commit 03945be

Browse files
i18n: Lingo Translation Update (docs)
1 parent 618f20c commit 03945be

91 files changed

Lines changed: 4575 additions & 495 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"title": "قبول المدفوعات",
3-
"pages": ["payment-button", "verification-tools", "indexing"],
3+
"pages": ["payment-button", "verification-tools", "indexing", "pay-sh"],
44
"defaultOpen": false
55
}
Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
title: مع Pay.sh
3+
description: قبول المدفوعات باستخدام Pay.sh.
4+
---
5+
6+
يمكنك قبول المدفوعات على طلبات API عبر Pay.sh من خلال إعداد خادم Pay. قم بتثبيت
7+
Pay باستخدام:
8+
9+
```bash
10+
brew install pay
11+
```
12+
13+
أو
14+
15+
```bash
16+
npm install -g @solana/pay
17+
```
18+
19+
تحقق من التثبيت باستخدام:
20+
21+
```bash
22+
pay --version
23+
```
24+
25+
ستقوم سلسلة الأدوات بإعداد عنوانك تلقائيًا. قم بتشغيل الأمر التالي لإعداد محفظتك
26+
وتعبئتها:
27+
28+
```bash
29+
pay setup
30+
```
31+
32+
## إعداد الخادم التجريبي
33+
34+
يمكنك البدء في قبول المدفوعات عن طريق تشغيل خادمك. يمكنك مشاهدة الخادم التجريبي
35+
في العمل باستخدام:
36+
37+
```bash
38+
pay server demo
39+
```
40+
41+
يقوم هذا بفعل شيئين. يبدأ خادم Pay مباشرًا يمكنك الاستعلام عنه عبر طلب HTTP،
42+
ويُنشئ ملف `pay-demo.yml` في دليلك الحالي.
43+
44+
يتم تهيئة جميع مسارات API عبر إعدادات YAML الخاصة بـ `endpoints`. لقبول
45+
المدفوعات، يجب عليك إضافة سمة `metering:`. وقد تم إعداد مسار
46+
`/api/v1/reports/usage` كمثال لك:
47+
48+
```yaml
49+
endpoints:
50+
- method: GET
51+
path: "api/v1/reports/usage"
52+
resource: "reports"
53+
description: "Usage report — flat fee, no splits."
54+
metering:
55+
dimensions:
56+
- direction: usage
57+
unit: requests
58+
scale: 1
59+
tiers:
60+
- price_usd: 0.01
61+
```
62+
63+
يمكنك اختبار أن المدفوعات تعمل بشكل صحيح عن طريق تشغيل الأمر التالي كعميل في
64+
محطة طرفية أخرى:
65+
66+
```bash
67+
pay --sandbox curl http://127.0.0.1:1402/api/v1/reports/usage
68+
```
69+
70+
يمكنك معرفة المزيد حول كيفية تحديد الأسعار في
71+
[وثائق Pay.sh - البناء مع Pay > التسعير](https://pay.sh/docs/building-with-pay/pricing)
72+
73+
تعرّف على المزيد حول إعداد Pay.sh في بيئة الإنتاج في
74+
[وثائق إعداد Pay.sh](https://pay.sh/docs/toolchain/configuration).

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

Lines changed: 54 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -32,29 +32,55 @@ description:
3232
التطبيقات تحدي `402 Payment Required` من نوع MPP أو x402، يطلب `pay` من محفظتك
3333
المحلية الموافقة على التوقيع.
3434

35+
يمكنك تثبيت Pay باستخدام:
36+
37+
```bash
38+
brew install pay
39+
```
40+
41+
أو
42+
43+
```bash
44+
npm install -g @solana/pay
45+
```
46+
47+
تحقق من التثبيت باستخدام:
48+
49+
```bash
50+
pay --version
51+
```
52+
53+
ستقوم سلسلة الأدوات بإعداد عنوانك تلقائيًا. شغّل الأوامر التالية لإعداد محفظتك
54+
وتعبئة رصيدها:
55+
56+
```bash
57+
pay setup
58+
```
59+
3560
## بروتوكول x402
3661

37-
تحتاج المدفوعات الوكيلية إلى طريقة للعملاء والخوادم للتفاوض على شروط الدفع عبر
38-
البنية التحتية القياسية للويب دون تعطيل واجهات الويب التقليدية. لا تزال مساحة
39-
الدفعات الصغيرة ناشئة ومن المحتمل أن تظهر أدوات ومعايير جديدة مع تطور المجال.
40-
ومع ذلك، برز [بروتوكول x402](https://www.x402.org/) كمعيار مبكر مع دعم قوي من
41-
النظام البيئي. يستخدم x402
42-
[رمز الحالة 402 "الدفع مطلوب" في HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/402) -
43-
وهو معيار منذ HTTP/1.1 أصبح عمليًا فقط مع التسوية عبر البلوكشين.
62+
تحتاج المدفوعات الذكية إلى آلية تتيح للعملاء والخوادم التفاوض على شروط الدفع عبر
63+
البنية التحتية للويب القياسية دون الإخلال بواجهات الويب التقليدية. لا يزال قطاع
64+
المدفوعات الصغيرة في طور النشأة، ومن المرجح أن تظهر أدوات ومعايير جديدة مع تطور
65+
هذا المجال. غير أن [بروتوكول x402](https://www.x402.org/) قد برز بوصفه معيارًا
66+
مبكرًا يحظى بدعم قوي من المنظومة البيئية. يستخدم x402 رمز الحالة
67+
[HTTP 402 "Payment Required"](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/402)
68+
وهو معيار موجود منذ HTTP/1.1 لم يصبح عمليًا إلا مع تسوية البلوكتشين.
4469

45-
### كيف يعمل
70+
### آلية العمل
4671

47-
يقوم العميل بإجراء طلب، ويتلقى رمز 402 مع شروط الدفع، ثم يعيد المحاولة بدفعة
48-
موقعة. يفوض الخادم التحقق والتسوية إلى ميسّر، وهو وسيط اختياري يتعامل مع إرسال
49-
المعاملة على السلسلة. بمجرد أن يؤكد الميسّر التسوية، يعيد الخادم المحتوى
50-
المطلوب. يتيح هذا الفصل لمزودي واجهات برمجة التطبيقات قبول المدفوعات دون إدارة
51-
أي بنية تحتية على السلسلة بشكل مباشر.
72+
يُرسل العميل طلبًا، فيتلقى استجابة 402 تتضمن شروط الدفع، ثم يُعيد المحاولة
73+
مرفقًا بدفعة موقّعة. يفوّض الخادم عملية التحقق والتسوية إلى جهة تيسير، وهي وسيط
74+
اختياري يتولى إرسال المعاملات على السلسلة. وبمجرد تأكيد الجهة المُيسِّرة
75+
للتسوية، يعيد الخادم إرسال المحتوى المطلوب. يتيح هذا الفصل لمزودي واجهات برمجة
76+
التطبيقات قبول المدفوعات دون الحاجة إلى إدارة أي بنية تحتية على السلسلة بشكل
77+
مباشر.
5278

5379
![مخطط تدفق x402](/assets/guides/x402/x402-flow-solana.png)
5480

55-
البروتوكول عديم الحالة (لا جلسات أو مفاتيح API)، ويعمل مع البنية التحتية
56-
القياسية لـ HTTP، ويدعم أي رمز SPL يقبله الخادم. إليك مقتطف حول كيفية إعداد خادم
57-
Express باستخدام وسيط x402:
81+
البروتوكول عديم الحالة (لا جلسات ولا مفاتيح API)، ويعمل مع البنية التحتية
82+
القياسية لـ HTTP، ويدعم أي رمز SPL يقبله الخادم. إليك مقتطفًا يوضح كيفية إعداد
83+
خادم Express باستخدام وسيط x402:
5884

5985
```ts
6086
app.use(
@@ -89,28 +115,28 @@ app.get("/costly-data", (req, res) => {
89115
});
90116
```
91117

92-
لمعرفة المزيد عن x402، راجع أدلتنا:
118+
لمعرفة المزيد حول x402، اطّلع على أدلتنا:
93119

94120
<Cards>
95121
<Card
96122
title="مقدمة إلى x402"
97123
href="/developers/guides/getstarted/intro-to-x402"
98-
description="أساسيات البروتوكول وخيارات SDK لبناء واجهات برمجية ممكّنة للدفع."
124+
description="أساسيات البروتوكول وخيارات SDK لبناء واجهات برمجة تطبيقات مُمكَّنة للدفع."
99125
/>
100126
<Card
101-
title="البناء باستخدام Kora"
127+
title="البناء مع Kora"
102128
href="/developers/guides/getstarted/build-a-x402-facilitator"
103-
description="تطبيق مدفوعات x402 بدون رسوم غاز باستخدام البنية التحتية للتوقيع من Kora."
129+
description="تنفيذ مدفوعات x402 بدون رسوم غاز باستخدام بنية Kora للتوقيع."
104130
/>
105131
</Cards>
106132

107133
### أدوات x402
108134

109-
| SDK | الوصف |
110-
| --------------------------------------------------------------- | -------------------------------- |
111-
| [Corbits](https://corbits.dev/) | تطبيق x402 مصمم أولاً لسولانا |
112-
| [MCPay.tech](https://mcpay.tech/) | الدفع مقابل كل طلب لخوادم MCP |
113-
| [PayAI](https://payai.network/) | ميسّر x402 مع دعم سولانا |
114-
| [x402 GitHub](https://github.com/coinbase/x402) | التطبيق المرجعي |
115-
| [ACK](https://github.com/agentcommercekit/ack) | مجموعة أدوات التجارة عبر الوكلاء |
116-
| [A2A x402](https://github.com/google-agentic-commerce/a2a-x402) | مدفوعات Google من وكيل إلى وكيل |
135+
| SDK | الوصف |
136+
| --------------------------------------------------------------- | ----------------------------------- |
137+
| [Corbits](https://corbits.dev/) | تطبيق x402 المبني على سولانا أولاً |
138+
| [MCPay.tech](https://mcpay.tech/) | الدفع لكل طلب لخوادم MCP |
139+
| [PayAI](https://payai.network/) | وسيط x402 مع دعم سولانا |
140+
| [x402 GitHub](https://github.com/coinbase/x402) | التطبيق المرجعي |
141+
| [ACK](https://github.com/agentcommercekit/ack) | مجموعة أدوات تجارة الوكلاء |
142+
| [A2A x402](https://github.com/google-agentic-commerce/a2a-x402) | مدفوعات الوكيل إلى الوكيل من Google |

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@
66
"fixed-delegation",
77
"recurring-delegation",
88
"subscription-plan",
9-
"close-subscription-authority"
9+
"close-subscription-authority",
10+
"pay-sh"
1011
],
1112
"defaultOpen": false
1213
}
Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
---
2+
title: مع Pay.sh
3+
description: أنشئ اشتراكات باستخدام Pay.sh.
4+
---
5+
6+
يمكنك إعداد الاشتراكات عبر Pay.sh من خلال تهيئة عميل Pay على جهازك أو إعداد خادم
7+
Pay. قم بتثبيت Pay باستخدام:
8+
9+
```bash
10+
brew install pay
11+
```
12+
13+
أو
14+
15+
```bash
16+
npm install -g @solana/pay
17+
```
18+
19+
تحقق من التثبيت باستخدام:
20+
21+
```bash
22+
pay --version
23+
```
24+
25+
ستقوم سلسلة الأدوات بإعداد عنوانك تلقائيًا. شغّل الأمر التالي لإعداد محفظتك
26+
وتعبئتها:
27+
28+
```bash
29+
pay setup
30+
```
31+
32+
## الاشتراكات كعميل
33+
34+
يشترك المستخدمون في نقاط نهاية API المحمية بالاشتراك عن طريق استدعاء pay
35+
بالطريقة المعتادة. يقع على عاتق API إرسال تفاصيل الاشتراك في الاستجابة الأولية
36+
`402 Status`. يتولى Pay معالجة الاشتراك تلقائيًا، بما في ذلك استدعاء التعليمات
37+
على برنامج سولانا SPL للاشتراكات.
38+
39+
يمكن للمستخدمين إدارة اشتراكاتهم باستخدام الأوامر التالية:
40+
41+
```bash
42+
pay subscriptions # default: list + show available subcommands
43+
pay subscriptions list # same, scriptable
44+
pay subscriptions list --network mainnet
45+
pay subscriptions list --json
46+
```
47+
48+
يمكنك معرفة المزيد حول إدارة اشتراكاتك كمستخدم في
49+
[Pay.sh > Using Pay > Manage Subscriptions docs](https://pay.sh/docs/using-pay/subscriptions).
50+
51+
## إدارة الاشتراكات كمزوّد (عرض تجريبي)
52+
53+
تتيح خوادم Pay تهيئة المشتركين واشتراكاتهم لكل نقطة نهاية. فيما يلي مثال على
54+
نقطة نهاية تستخدم pay ويمكنك تجربتها مع مشروعك:
55+
56+
```yaml
57+
# monthly.yml
58+
name: Subscriptions Example
59+
subdomain: subscriptions-example
60+
title: "Subscription Example"
61+
description: "Demo Subscriptions"
62+
category: ai_ml
63+
version: v1
64+
routing:
65+
type: respond
66+
operator:
67+
currencies:
68+
usd: ["USDC", "USDT", "CASH"]
69+
network: "localnet"
70+
fee_payer: true
71+
challenge_binding_secret: d858d9104afd728f58a1f73d806dd75d8f32ebd37c9707145816b490e8631d41
72+
# insert your own challenge_binding_secret here. use `openssl rand -hex 32`
73+
74+
endpoints:
75+
- method: GET
76+
path: "api/v1/pro/feed"
77+
resource: "pro-feed"
78+
description: "Pro feed — monthly subscription, 30-day billing period."
79+
subscription:
80+
period: "30d"
81+
price_usd: 9.99
82+
currency: USDC
83+
plan_id_numeric: 1
84+
```
85+
86+
يعالج Pay الاشتراكات باستخدام الخاصية `subscription:` في مواصفات `endpoints`
87+
YAML الخاصة به. وهذا على عكس الخاصية `metering:` المستخدمة لنقاط النهاية ذات
88+
الدفع عند الاستخدام.
89+
90+
يؤدي تشغيل الخادم في المثال أعلاه إلى إنشاء نقطة نهاية تُسمى `api/v1/pro/feed`
91+
تتطلب من المستخدم إجراء مدفوعات متكررة بقيمة 9.99 USDC كل 30 يومًا.
92+
93+
يمكنك تجربته بتشغيل الأمر التالي:
94+
95+
```bash
96+
pay server start monthly.yml
97+
```
98+
99+
سيطلب منك تشغيل هذا الأمر إنشاء خطة. يؤدي ذلك إلى إنشاء خطة وتحديث ملف yml. إذا
100+
كنت ستستخدمه مجددًا، احتفظ بعنوان الخطة واستخدمه في إعداداتك أثناء إجراء
101+
التغييرات.
102+
103+
يمكنك اختبار أن الاشتراكات تعمل بشكل صحيح عن طريق تشغيل الأوامر التالية كعميل في
104+
طرفية أخرى:
105+
106+
```bash
107+
# First call — activates the subscription, $9.99 USDC charge settles.
108+
pay --sandbox curl http://127.0.0.1:1402/api/v1/pro/feed
109+
110+
# Same call within 30 days — no payment prompt, just the response.
111+
pay --sandbox curl http://127.0.0.1:1402/api/v1/pro/feed
112+
```
113+
114+
يجب أن ترى حالة OK كاستجابة على النحو التالي:
115+
116+
```json
117+
{ "status": "ok" }
118+
```
119+
120+
يمكنك معرفة المزيد حول إدارة الاشتراكات على خادم Pay عبر
121+
[Pay.sh > Building with Pay > Subscriptions > YAML Specification docs](https://pay.sh/docs/building-with-pay/subscriptions/yaml-specification).
Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
22
"title": "Zahlungen akzeptieren",
3-
"pages": ["payment-button", "verification-tools", "indexing"],
3+
"pages": ["payment-button", "verification-tools", "indexing", "pay-sh"],
44
"defaultOpen": false
55
}

0 commit comments

Comments
 (0)