مجموعة Postman

استورد كل طلبات /v1 في تيرا باي إلى Postman، مع متغيرات لمفتاحك ومفاتيح منع تكرار تلقائية.

تحتوي مجموعة Postman الخاصة بتيرا باي على كل طلبات الـ API العامة /v1: المدفوعات والاستردادات وروابط الدفع والإيداعات ونقاط نهاية الـ Webhooks.

الإعداد

في Postman اختر Import، ثم أفلت الملف teyra-pay.postman_collection.json.

افتح المجموعة، واذهب إلى Variables واضبط:

المتغير	القيمة
`baseUrl`	`https://api.teyra.co`
`secretKey`	مفتاح الاختبار السري `sk_test_…` من المطورون ← مفاتيح API

استخدم مفتاح اختبار أثناء التجربة، فالطلبات بمفتاح حي تُنشئ مدفوعات حقيقية.

شغّل Payments ← Create a payment، ثم افتح checkout_url من الاستجابة وادفع ببطاقة اختبار.

المصادقة. يرسل كل طلب Authorization: Bearer {{secretKey}}.
مفاتيح منع التكرار. يضيف سكربت ما قبل الطلب في المجموعة ترويسة Idempotency-Key جديدة إلى كل طلب POST لا يحتوي عليها. لترى إعادة الاستجابة المحفوظة، أضف الترويسة بنفسك بقيمة ثابتة وأرسل الطلب مرتين.
حفظ المعرّفات. تحفظ طلبات الإنشاء المعرّف الجديد في {{paymentId}} أو {{refundId}} أو {{paymentLinkId}} أو {{webhookEndpointId}}، فتعمل طلبات الاسترجاع والاسترداد والإيقاف والحذف مباشرة.
ترقيم الصفحات. تحفظ طلبات القوائم قيمة next_cursor في {{nextCursor}}. فعّل معامل cursor لتحميل الصفحة التالية.

المبالغ أعداد صحيحة بأصغر وحدة للعملة: 12500 تعني 12.500 دينار كويتي. راجع المبالغ والعملات.

عندما تصبح جاهزًا لكتابة الكود، استخدم مكتبة Node.js أو مكتبة PHP، أو استدعِ الـ API مباشرة بالاستعانة بـ مرجع الـ API.