اقبل كي-نت ومدى والبطاقات وApple Pay عبر واجهة واحدة.
تيرا باي توفر لك صفحة دفع مستضافة لمنطقة الخليج. أنشئ عملية دفع من خادمك، ووجّه العميل إلى checkout_url، واستلم إشعار Webhook موقّعًا عند اكتمال الدفع.
curl https://api.teyra.co/v1/payments \ -H "Authorization: Bearer sk_test_…" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: order-1042" \ -d '{"amount": 12500, "currency": "KWD", "return_url": "https://shop.example.com/thanks"}'
{
"id": "pay_01JBX4T9W2",
"status": "requires_payment",
"amount": 12500, // 12.500 KWD
"currency": "KWD",
"checkout_url": "https://api.teyra.co/checkout/pay_01JBX4T9W2"
}كيف تمر عملية الدفع
- 1
الإنشاء
يستدعي خادمك POST /v1/payments بالمبلغ بالوحدات الصغرى مع return_url.
requires_payment - 2
التوجيه
وجّه العميل إلى checkout_url ليدفع عبر كي-نت أو مدى أو البطاقة أو Apple Pay أو بنفت.
processing - 3
العودة
يعود العميل إلى return_url ومعه payment_id وstatus في الرابط.
return_url?status=… - 4
التأكيد
نفّذ الطلب فقط بعد GET /v1/payments/:id أو إشعار payment.succeeded تم التحقق من توقيعه.
succeeded
الأدلة
البداية
قبول المدفوعات
وسائل الدفع
- كي-نت
- مدى
- Visa
- Mastercard
- American Express
- Apple Pay
- Google Pay
- بنفت
- STC Pay