Skip to content

Commit 0bc4b70

Browse files
i18n: Lingo Translation Update (docs) (#1673)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 473c044 commit 0bc4b70

91 files changed

Lines changed: 4581 additions & 500 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: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
title: مع Pay.sh
3+
description: اقبل المدفوعات باستخدام Pay.sh.
4+
---
5+
6+
يمكنك قبول المدفوعات على طلبات API عبر Pay.sh من خلال إعداد خادم Pay. ثبّت Pay
7+
باستخدام:
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:`. وقد تم تنفيذ مسار `/api/v1/reports/usage` كمثال
46+
توضيحي لك:
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+
```bash
66+
pay --sandbox curl http://127.0.0.1:1402/api/v1/reports/usage
67+
```
68+
69+
يمكنك الاطلاع على مزيد من المعلومات حول كيفية تحديد الأسعار في
70+
[وثائق Pay.sh - البناء مع Pay > التسعير](https://pay.sh/docs/building-with-pay/pricing)
71+
72+
تعرف على المزيد حول إعداد Pay.sh في بيئة الإنتاج في
73+
[وثائق تكوين Pay.sh](https://pay.sh/docs/toolchain/configuration).

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

Lines changed: 53 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -32,29 +32,54 @@ 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+
المدفوعات دون الحاجة إلى إدارة أي بنية تحتية على السلسلة بشكل مباشر.
5277

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

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

5984
```ts
6085
app.use(
@@ -89,28 +114,28 @@ app.get("/costly-data", (req, res) => {
89114
});
90115
```
91116

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

94119
<Cards>
95120
<Card
96121
title="مقدمة إلى x402"
97122
href="/developers/guides/getstarted/intro-to-x402"
98-
description="أساسيات البروتوكول وخيارات SDK لبناء واجهات برمجية ممكّنة للدفع."
123+
description="أساسيات البروتوكول وخيارات SDK لبناء واجهات برمجة تطبيقات تدعم الدفع."
99124
/>
100125
<Card
101-
title="البناء باستخدام Kora"
126+
title="البناء مع Kora"
102127
href="/developers/guides/getstarted/build-a-x402-facilitator"
103-
description="تطبيق مدفوعات x402 بدون رسوم غاز باستخدام البنية التحتية للتوقيع من Kora."
128+
description="تنفيذ مدفوعات x402 بدون رسوم غاز باستخدام بنية التوقيع الخاصة بـ Kora."
104129
/>
105130
</Cards>
106131

107132
### أدوات x402
108133

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 من وكيل إلى وكيل |
134+
| SDK | الوصف |
135+
| --------------------------------------------------------------- | ---------------------------------- |
136+
| [Corbits](https://corbits.dev/) | تنفيذ x402 بأولوية سولانا |
137+
| [MCPay.tech](https://mcpay.tech/) | الدفع لكل طلب لخوادم MCP |
138+
| [PayAI](https://payai.network/) | ميسّر x402 مع دعم سولانا |
139+
| [x402 GitHub](https://github.com/coinbase/x402) | التنفيذ المرجعي |
140+
| [ACK](https://github.com/agentcommercekit/ack) | مجموعة أدوات تجارة الوكلاء |
141+
| [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 Subscriptions.
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 > استخدام Pay > وثائق إدارة الاشتراكات](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)