# Alphabet Bridge Docs

> What the Alphabet Payment Bridge is, and how test and live keys work.

## English

- [Introduction](https://pay.alphabet.iq/docs/en/introduction.md): What the Alphabet Payment Bridge is, and how test and live keys work.
- [Quickstart](https://pay.alphabet.iq/docs/en/quickstart.md): Take your first test payment in five minutes with curl.
- [Test mode](https://pay.alphabet.iq/docs/en/test-mode.md): Drive test payments to paid, failed, cancelled, expired and refunded with the built-in simulator.
- [Payment flow](https://pay.alphabet.iq/docs/en/payment-flow.md): From creating a payment to confirming it, and why the redirect alone is never proof.
- [Statuses](https://pay.alphabet.iq/docs/en/statuses.md): Every payment status, which changes are possible, and the event each one sends.
- [Webhooks](https://pay.alphabet.iq/docs/en/webhooks.md): Signed events on every payment status change, how to verify them, and retries for 24 hours.
- [Refunds](https://pay.alphabet.iq/docs/en/refunds.md): Test-mode refunds through the API; live refunds requested from the dashboard and counted once the provider confirms them.
- [Errors](https://pay.alphabet.iq/docs/en/errors.md): Every error code the API returns, with its HTTP status and what to do.
- [Authentication](https://pay.alphabet.iq/docs/en/authentication.md): Send your API key as a bearer token; test and live keys, rolling and limits.
- [Payments](https://pay.alphabet.iq/docs/en/payments.md): Create, fetch and cancel payments; every field, idempotency and the order-reference rule.
- [Docs MCP server](https://pay.alphabet.iq/docs/en/mcp.md): Add the bridge's documentation to an AI client over MCP.

## العربية

- [مقدمة](https://pay.alphabet.iq/docs/ar/introduction.md): ما هو جسر الدفع من ألفابت، وكيف تعمل المفاتيح التجريبية والفعلية.
- [البدء السريع](https://pay.alphabet.iq/docs/ar/quickstart.md): نفّذ أول دفعة تجريبية خلال خمس دقائق باستخدام curl.
- [الوضع التجريبي](https://pay.alphabet.iq/docs/ar/test-mode.md): وجّه الدفعات التجريبية إلى مدفوعة أو مرفوضة أو ملغاة أو منتهية أو مستردة باستخدام المحاكي المدمج.
- [مسار الدفع](https://pay.alphabet.iq/docs/ar/payment-flow.md): من إنشاء الدفعة حتى التأكد منها، ولماذا لا تكفي إعادة التوجيه وحدها دليلاً.
- [الحالات](https://pay.alphabet.iq/docs/ar/statuses.md): كل حالات الدفعة، والتغييرات الممكنة بينها، والحدث الذي يرسله كل تغيير.
- [إشعارات Webhook](https://pay.alphabet.iq/docs/ar/webhooks.md): أحداث موقّعة عند كل تغيّر في حالة الدفعة، وكيف تتحقق منها، وإعادة الإرسال لمدة 24 ساعة.
- [الاسترداد](https://pay.alphabet.iq/docs/ar/refunds.md): الاسترداد التجريبي عبر الواجهة البرمجية، والاسترداد الفعلي يُطلب من لوحة التحكم ولا يُحتسب إلا بعد تأكيد المزوّد.
- [الأخطاء](https://pay.alphabet.iq/docs/ar/errors.md): كل رموز الأخطاء التي ترجعها الواجهة البرمجية، مع حالة HTTP وما يجب فعله.
- [المصادقة](https://pay.alphabet.iq/docs/ar/authentication.md): أرسل مفتاح API كرمز Bearer؛ المفاتيح التجريبية والفعلية، وتبديل المفاتيح، والحدود.
- [الدفعات](https://pay.alphabet.iq/docs/ar/payments.md): إنشاء الدفعات وجلبها وإلغاؤها؛ كل الحقول، ومنع التكرار، وقاعدة مرجع الطلب.
- [خادم MCP للدليل](https://pay.alphabet.iq/docs/ar/mcp.md): أضف توثيق الجسر إلى عميل الذكاء الاصطناعي عبر MCP.