SofizPay Logo

SofizPay

SofizPay Logo
SofizPay
التوثيق التقني
توليد رمز الاستجابة السريعة

توليد رموز QR لـ SofizPay

تعلم كيفية بناء وإنشاء رموز QR المتوافقة مع الماسح الضوئي لـ SofizPay لإتمام عمليات الدفع بسلاسة داخل التطبيق.

المفتاح العام (PublicKey)

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

المبلغ (Amount)

قيمة المعاملة المطلوب دفعها. يجب أن تكون مسبوقة بـ &a=.

المذكرة (Memo/Data)

وصف اختياري للمعاملة، مثل رقم الفاتورة أو معرّف الطلب. يجب أن يكون مسبوقًا بـ &dt=.

خطوات التوليد

1

بناء سلسلة البيانات

الخطوة الأولى هي تجميع المفتاح العام والمبلغ والمذكرة بالتنسيق المطلوب.

javascript
// Format: publicKey&a=amount&dt=memo

// Example:
const publicKey = "YOUR_PUBLIC_KEY";
const amount = "2500.50"; // The amount to be paid
const memo = "Order-9876";   // An optional memo or invoice ID

const qrCodeString = `${publicKey}&a=${amount}&dt=${memo}`;

// Resulting string for the QR Code:
// "YOUR_PUBLIC_KEY&a=2500.50&dt=Order-9876"
2

استخدام مكتبة لتوليد الرمز

استخدم أي مكتبة قياسية لإنشاء رمز QR من سلسلة البيانات التي أنشأتها.

javascript
// Example using the 'qrcode.react' library in a React project
// Installation: npm install qrcode.react

import { QRCodeSVG } from 'qrcode.react';

const qrString = "YOUR_PUBLIC_KEY&a=2500.50&dt=Order-9876";

function PaymentQRCode() {
  return <QRCodeSVG value={qrString} size={256} />;
}
3

عرض واختبار الرمز

اعرض الرمز الذي تم إنشاؤه في تطبيقك، ثم اختبره باستخدام الماسح الضوئي SofizPay QR للتأكد من قراءة البيانات بشكل صحيح.

javascript
// Ensure the QR code is clearly visible in your app's UI.
// Test with the SofizPay QR Scanner to verify that
// the amount and memo appear correctly before payment.

تفاصيل المعلمات (Parameters)

المعلمة: publicKey (مطلوب)

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

المعلمة: &a= (مطلوب)

مبلغ الدفع. استخدم النقطة (.) كفاصل عشري. هذا الحقل إلزامي لعملية دفع صالحة.

المعلمة: &dt= (اختياري)

مذكرة أو بيانات اختيارية مثل رقم الطلب. إذا كانت تحتوي على أحرف خاصة، فمن المستحسن ترميزها (URL-encode).