الانتقال إلى المحتوى الرئيسي
Pix هو نظام الدفع الفوري في البرازيل الذي أنشأه البنك المركزي البرازيلي (Banco Central do Brasil). يتيح التحويلات الفورية على مدار الساعة طوال أيام الأسبوع، بما في ذلك العطلات ونهايات الأسبوع، وأصبح الوسيلة الأكثر شعبية للدفع في البرازيل.

​
لماذا تقدم Pix؟

Dominant in Brazil

Pix هو أكثر طرق الدفع استخداماً في البرازيل، متفوقاً على بطاقات الائتمان و boleto.

Instant Settlement

تأكيد المدفوعات في ثوانٍ، 24/7/365 — لا حاجة لانتظار نوافذ معالجة البنك.

Low Friction

يدفع العملاء باستخدام رمز الاستجابة السريعة أو مفتاح النسخ واللصق — لا حاجة لأرقام البطاقات أو تفاصيل البنك.

​
نظرة عامة

تفاصيلالقيمة
عملة الفوترةBRL
البلدان المدعومةالبرازيل
الاشتراكاتلا
الحد الأدنى للمبلغ0.50 دولار
التسويةفورية

​
كيف يعمل

​
تجربة العملاء

  1. يختار العميل خدمة Pix عند الدفع
  2. يتم عرض رمز الاستجابة السريعة ومفتاح النسخ واللصق
  3. يفتح العميل تطبيقه البنكي ويمسح رمز الاستجابة السريعة أو يلصق المفتاح
  4. يتم تأكيد الدفع فوراً
  5. يتم إعادة العملاء إلى صفحة النجاح
عادة ما تنتهي صلاحية رموز الاستجابة السريعة الخاصة بـ Pix بعد فترة محددة. إذا لم يكمل العميل الدفع في الوقت المحدد، يجب عليهم إعادة بدء عملية الخروج.

​
التكوين

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['pix', 'credit', 'debit'],
  billing_currency: 'BRL',
  return_url: 'https://example.com/success'
});

​
نوع طريقة API

النوعالطريقةالبلد
pixPixالبرازيل

​
الاختبار

1

Enable test mode

استخدم مفاتيح API الاختبارية الخاصة بـ Dodo Payments.
2

Set billing currency to BRL

تأكد من تعيين عملة الفوترة إلى BRL في طلب الدفع الخاص بك.
3

Enter test CPF and scan the QR code

عند الطلب لإدخال CPF لـ Pix، أدخل 1234567890. سيتم إنشاء رمز استجابة سريعة اختبار — امسحه بواسطة كاميرا الهاتف العادية (لا حاجة لتطبيق Pix). سيتم تحويلك إلى صفحة اختبار Stripe حيث يمكنك محاكاة العملية كنجاح أو فشل.

​
أفضل الممارسات

يعمل Pix فقط مع BRL. تأكد من أن الأسعار الخاصة بك تدعم معاملات الريال البرازيلي للسوق البرازيلية.
قد لا يفضل جميع العملاء البرازيليين Pix. يجب دائماً تضمين credit و debit كخيارات احتياطية.
تنتهي صلاحية رموز Pix للاستجابة السريعة بعد فترة محددة. تأكد من أن عملية الدفع الخاصة بك تتعامل مع انتهاء الصلاحية بسلاسة وتسمح للعملاء بإعادة توليد الرمز.

​
استكشاف الأخطاء وإصلاحها

تأكد:
  1. هل تم تعيين عملة الفوترة إلى BRL؟
  2. هل تم تضمين pix في allowed_payment_method_types؟
  3. هل بلد الفواتير للعميل هو البرازيل؟
الحل: Pix متاح فقط للمعاملات بالريال البرازيلي. تحقق من العملة وعنوان الفواتير في طلب API الخاص بك.
السبب: لم يكمل العميل الدفع ضمن فترة الصلاحية.الحل: يحتاج العميل لإعادة عملية الدفع لتوليد رمز استجابة سريعة جديد.
السبب: تتأكد مدفوعات Pix فوراً في معظم الحالات، ولكن قد تحدث أحياناً تأخيرات من الجهة المصرفية.الحل: راقب إشعارات الويب للتأكد من الدفع. إذا لم يتم تأكيد الدفع في غضون بضع دقائق، تعامل معه كفشل.

​
الصفحات ذات الصلة

Payment Methods Overview

اطلع على جميع طرق الدفع المدعومة.

Adaptive Currency

دعم العملات والتحويل التلقائي.

Checkout Guide

دليل تنفيذ عملية الدفع الكامل.

Webhooks

التعامل مع تأكيدات الدفع بشكل غير متزامن.
Last modified on April 1, 2026