Pix

يمكن للعملاء البرازيليين الدفع من تطبيقهم المصرفي عبر مسح رمز QR أو لصق رمز Pix. Pix هو نظام الدفع الفوري في البرازيل، وقد أنشأه البنك المركزي البرازيلي (Banco Central do Brasil). ينقل الأموال في الوقت الفعلي على مدار الساعة، طوال أيام السنة، بما في ذلك عطلات نهاية الأسبوع والعطلات الرسمية. يوفّر Dodo Payments خدمة Pix للدفعات لمرة واحدة والاشتراكات المفوترة بـ BRL.

لماذا تقدم Pix؟

Dominant in Brazil

يُعد Pix طريقة الدفع الأكثر استخدامًا في البرازيل، متقدمًا على بطاقات الائتمان وboleto. ويفيد البنك المركزي البرازيلي بأن Pix شكّل 54.7% من جميع معاملات الدفع في النصف الثاني من عام 2025.

Instant Settlement

تكتمل تحويلات Pix خلال ثوانٍ، في أي ساعة وفي أي يوم من أيام السنة، لذلك لا توجد فترة معالجة مصرفية يتعين انتظارها.

Low Friction

يمسح العميل رمز QR أو يلصق رمز Pix في تطبيقه المصرفي. ولا يحتاج إلى إدخال أرقام البطاقات أو التفاصيل المصرفية.

نظرة عامة

الحد الأدنى هو الحد الأدنى لعملية checkout بعملة BRL، لذا ينطبق على كل طريقة دفع في عملية checkout بعملة BRL. يجب أيضًا ألا تقل دفعة BRL عن ما يعادل $0.50 للدفعات لمرة واحدة و$1.00 للاشتراكات. راجع الحد الأدنى للمبالغ.

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

آلية العمل

تجربة العميل

يحدد العميل Pix عند الدفع ويدخل CPF الخاص به (رقم التعريف الضريبي البرازيلي المكوّن من 11 رقمًا) في حقل Pix CPF.
يؤكد العميل عملية الدفع. يظهر رمز QR في نافذة تراكب بملء الشاشة، مع رمز Pix وزر نسخ الرمز أسفله.
يفتح العميل تطبيقه المصرفي، ويحدد Pix، ثم يمسح رمز QR أو يلصق رمز Pix.
يتم تأكيد الدفع خلال ثوانٍ.
تكتشف صفحة الدفع اكتمال الدفع وتعيد توجيه العميل إلى صفحة النجاح الخاصة بك.

تنتهي صلاحية رمز Pix QR بعد فترة محدودة. إذا لم يدفع العميل في الوقت المحدد، فعليه بدء عملية دفع جديدة من موقعك.

الإعداد

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

يظهر Pix في صفحات الدفع للدفعات لمرة واحدة والاشتراكات المفوترة بـ BRL. لا يفوتر Dodo Payments بـ BRL إلا عند تمكين Adaptive Currency، لذا فعّله قبل تقديم Pix.

نوع طريقة API

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

الاختبار

Enable Test Mode

عطّل مفتاح الوضع المباشر في الشريط الجانبي للوحة المعلومات، واستخدم API keys التي أُنشئت في وضع الاختبار.

Set Billing Currency to BRL

فعّل Adaptive Currency. ثم أنشئ جلسة دفع باستخدام billing_currency: 'BRL' وpix في allowed_payment_method_types.

Enter Test CPF and Scan the QR Code

في حقل Pix CPF، أدخل 00000000000 (11 صفرًا). تعرض صفحة الدفع رمز QR للاختبار. امسحه باستخدام كاميرا هاتفك؛ ولا تحتاج إلى تطبيق Pix أو تطبيق مصرفي. يفتح رمز QR صفحة اختبار يمكنك فيها محاكاة عملية دفع ناجحة أو فاشلة.

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

Set billing currency to BRL

يعمل Pix فقط في صفحات الدفع المفوترة بـ BRL، ولا يفوتر Dodo Payments بـ BRL إلا عند تمكين Adaptive Currency. فعّل Adaptive Currency حتى يتم عرض الأسعار على العملاء في البرازيل وفوترتهم بـ BRL.

Provide card fallbacks

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

Handle QR code expiration

تنتهي صلاحية رموز Pix QR بعد فترة محدودة. إذا عاد العميل بعد انتهاء صلاحية الرمز، فأنشئ له جلسة دفع جديدة.

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

Pix not appearing at checkout

تحقق:

هل عملة الفوترة هي BRL؟
هل pix مُدرج في allowed_payment_method_types؟
هل بلد فوترة العميل هو البرازيل (BR)؟ باستخدام Adaptive Currency، يحدد عنوان فوترة برازيلي عملة الفوترة لتكون BRL.
هل Adaptive Currency مفعّل؟
هل يستوفي المبلغ الحد الأدنى البالغ 0.50 BRL والحد الأدنى بالدولار الأمريكي؟

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

QR code expired

السبب: لم يُكمل العميل الدفع ضمن فترة انتهاء الصلاحية.الحل: يحتاج العميل إلى بدء عملية دفع جديدة من موقعك. لإرسال رابط دفع جديد إليه، أنشئ جلسة دفع جديدة.

Payment pending

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

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

Payment Methods Overview

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

Adaptive Currency

فوّتِر العملاء بعملتهم المحلية، بما في ذلك BRL.

Checkout Guide

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

Webhooks

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

Testing Process

بيانات الاختبار وإرشادات اختبار عملية الدفع.

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

Testing Process

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

Dominant in Brazil

Instant Settlement

Low Friction

​نظرة عامة

​آلية العمل

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

​الإعداد

​نوع طريقة API

​الاختبار

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

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

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

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Testing Process

لماذا تقدم Pix؟

نظرة عامة

آلية العمل

تجربة العميل

الإعداد

نوع طريقة API

الاختبار

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

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

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