Pix

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

لماذا تقدم Pix؟

Dominant in Brazil

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

Instant Settlement

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

Low Friction

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

نظرة عامة

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

كيف يعمل

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

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

عادة ما تنتهي صلاحية رموز الاستجابة السريعة الخاصة بـ 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

النوع	الطريقة	البلد
`pix`	Pix	البرازيل

الاختبار

Enable test mode

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

Set billing currency to BRL

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

Enter test CPF and scan the QR code

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

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

Set billing currency to BRL

يعمل Pix فقط مع BRL. تأكد من أن الأسعار الخاصة بك تدعم معاملات الريال البرازيلي للسوق البرازيلية.

Provide card fallbacks

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

Handle QR code expiration

تنتهي صلاحية رموز Pix للاستجابة السريعة بعد فترة محددة. تأكد من أن عملية الدفع الخاصة بك تتعامل مع انتهاء الصلاحية بسلاسة وتسمح للعملاء بإعادة توليد الرمز.

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

Pix not appearing at checkout

تأكد:

هل تم تعيين عملة الفوترة إلى BRL؟
هل تم تضمين pix في allowed_payment_method_types؟
هل بلد الفواتير للعميل هو البرازيل؟

الحل: Pix متاح فقط للمعاملات بالريال البرازيلي. تحقق من العملة وعنوان الفواتير في طلب API الخاص بك.

QR code expired

السبب: لم يكمل العميل الدفع ضمن فترة الصلاحية.الحل: يحتاج العميل لإعادة عملية الدفع لتوليد رمز استجابة سريعة جديد.

Payment pending

السبب: تتأكد مدفوعات Pix فوراً في معظم الحالات، ولكن قد تحدث أحياناً تأخيرات من الجهة المصرفية.الحل: راقب إشعارات الويب للتأكد من الدفع. إذا لم يتم تأكيد الدفع في غضون بضع دقائق، تعامل معه كفشل.

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

Payment Methods Overview

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

Adaptive Currency

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

Checkout Guide

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

Webhooks

التعامل مع تأكيدات الدفع بشكل غير متزامن.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

لماذا تقدم Pix؟

Dominant in Brazil

Instant Settlement

Low Friction

نظرة عامة

كيف يعمل

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

التكوين

نوع طريقة API

الاختبار

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

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

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

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

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

Dominant in Brazil

Instant Settlement

Low Friction

​نظرة عامة

​كيف يعمل

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

​التكوين

​نوع طريقة API

​الاختبار

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

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

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

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

لماذا تقدم Pix؟

نظرة عامة

كيف يعمل

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

التكوين

نوع طريقة API

الاختبار

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

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

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