رسائل الفواتير والإيصالات

يمكن لتيرا باي أن ترسل إلى عملائك فاتورة بالبريد الإلكتروني مع زر «ادفع الآن» وإيصالًا بعد الدفع، باسم نشاطك، بالعربية أو الإنجليزية.

ترسل تيرا باي رسالتين إلى عملائك:

رسالة الفاتورة: المبلغ والوصف واسم نشاطك وزر ادفع الآن الذي يفتح رابط الدفع checkout_url.
الإيصال: يُرسل بعد نجاح الدفعة، ويعرض اسم نشاطك والمبلغ والعملة التي دفعها العميل، والتاريخ والوقت، وطريقة الدفع (مع نوع البطاقة وآخر 4 أرقام عند توفرها)، والمرجع الخاص بك (أو رقم الدفعة إن لم يوجد مرجع)، والوصف.

تحتاج الرسالتان إلى بريد العميل في الدفعة (customer.email). ولا تعرضان إلا ما يدفعه العميل، ولا تظهر فيهما رسوم تيرا باي أبدًا.

متى تُرسل رسالة الفاتورة

طريقة إنشاء الدفعة	رسالة الفاتورة
لوحة التحكم ← الفواتير ← إنشاء فاتورة، مع بريد العميل	تُرسل دائمًا.
`POST /v1/payments` مع `send_email: true` و`customer.email`	تُرسل.
`POST /v1/payments` بدون `send_email`	لا تُرسل. ترسل أنت رابط `checkout_url` بنفسك.

curl https://api.teyra.co/v1/payments \
  -H "Authorization: Bearer $TEYRA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: invoice-2026-118" \
  -d '{
    "amount": 12500,
    "currency": "KWD",
    "return_url": "https://shop.example.com/return",
    "description": "2 × Arabic coffee beans 1 kg",
    "reference": "INV-1042",
    "customer": { "name": "Fatima Hassan", "email": "fatima@example.com" },
    "language": "ar",
    "expires_in_minutes": 10080,
    "send_email": true
  }'

إرسال send_email: true بدون customer.email يعيد 422 validation_error مع details.fields["customer.email"] = "required".

رسائل الفواتير والإيصالات

متى تُرسل رسالة الفاتورة

إعادة إرسال الفاتورة

متى يُرسل الإيصال

اللغة

المرسل والردود

وضع الاختبار

في هذه الصفحة