تكامل Amazon Payment Services (PayFort): دليل التجارة الإلكترونية الكامل للشرق الأوسط

جدول المحتويات

1. نظرة عامة على Amazon Payment Services
2. خيارات التكامل
3. تكامل صفحة التاجر
4. إنشاء التوقيع
5. الترميز للمدفوعات المتكررة
6. مدفوعات التقسيط
7. تكامل KNET للكويت

نظرة عامة على Amazon Payment Services

Amazon Payment Services (المعروفة سابقاً بـ PayFort) هي بوابة الدفع المفضلة لمؤسسات الشرق الأوسط:

• دعم متعدد لدول الخليج - الإمارات، السعودية، مصر، الكويت، البحرين، قطر
• دعم أمازون - موثوقية على مستوى المؤسسات
• الاستحواذ المحلي - اتصالات مباشرة مع البنوك في كل دولة
• التقسيط - BNPL مدمج للبنوك الإقليمية

تكامل صفحة التاجر

خدمة الدفع

export class APSPaymentService {
  generateSignature(params: Record<string, string>, phrase: string): string {
    // ترتيب المعلمات أبجدياً
    const sortedKeys = Object.keys(params).sort();
    
    // تسلسل: PHRASE + أزواج key=value + PHRASE
    let signatureString = phrase;
    for (const key of sortedKeys) {
      signatureString += `${key}=${params[key]}`;
    }
    signatureString += phrase;

    return crypto.createHash('sha256').update(signatureString).digest('hex');
  }

  async createPaymentRequest(params) {
    const paymentParams = {
      command: 'PURCHASE',
      access_code: APS_CONFIG.accessCode,
      merchant_identifier: APS_CONFIG.merchantIdentifier,
      merchant_reference: params.orderId,
      amount: Math.round(params.amount * 100).toString(),
      currency: params.currency.toUpperCase(),
      language: 'ar',
      customer_email: params.customerEmail,
      return_url: params.returnUrl,
    };

    paymentParams.signature = this.generateSignature(
      paymentParams,
      APS_CONFIG.shaRequestPhrase
    );

    return {
      paymentUrl: `${APS_CONFIG.baseUrl}/FortAPI/paymentPage`,
      formData: paymentParams,
    };
  }
}

مدفوعات التقسيط

const installmentParams = {
  ...baseParams,
  installments: 'STANDALONE',
  plan_code: 'PLAN_CODE',
  issuer_code: 'BANK_CODE',
  number_of_installments: '6', // 3، 6، 9، 12 شهر
};

تكامل KNET للكويت

const knetParams = {
  ...baseParams,
  payment_option: 'KNET',
  currency: 'KWD', // KNET يتطلب عملة الدينار الكويتي
  amount: Math.round(amount * 1000).toString(), // بالفلس
};

الخلاصة

تكامل Amazon Payment Services يتطلب:

1. إنشاء التوقيع - SHA-256 بالترتيب الصحيح
2. التحقق من الاستجابة - دائماً تحقق من توقيعات callback
3. معالجة العملة - وحدات صغرى مختلفة لكل عملة
4. الطرق الإقليمية - KNET للكويت، توجيه مدى للسعودية