وثائق API لـ Apple Pay

📋 المتطلبات الأساسية

• ✓ معرف حساب الشريك - معرف حسابك الفريد في MONDO
• ✓ مفتاح الشريك السري - مفتاح مصادقة API الخاص بك
• ✓ HTTPS - يجب أن يستخدم موقعك HTTPS

🔄 تدفق الدفع

🔗 نقطة نهاية API

نقطة تحقق التاجر

معايير التحقق من التاجر

📝 المعاملات المطلوبة (معالجة الدفع)

المعاملات الاختيارية

📤 استجابة API

تتم معالجة مدفوعات Apple Pay على الفور. الرد يحتوي على حالة المعاملة النهائية:

{
    "status": "success",
    "transaction_status": "COMPLETED",
    "gateway_session_id": "73d68b79579eeaa4a1f35f667509ba19",
    "transaction_id": "37819a4707f3736b6fb42148d98f05ab",
    "gateway_message": "Transaction succeeded",
    "redirect_url": "https://yoursite.com/success?gateway_session_id=...&payment_status=COMPLETED"
}

حقول الاستجابة

🍎 تكامل Apple Pay JS

الخطوة 1: إضافة زر Apple Pay

<apple-pay-button buttonstyle="black" type="plain" locale="en" onclick="startApplePayPayment()"></apple-pay-button>

الخطوة 2: تحقق من التوفر

if (window.ApplePaySession && ApplePaySession.canMakePayments()) {
    document.getElementById('apple-pay-button').style.display = 'block';
}

الخطوة 3: إكمال التنفيذ

async function startApplePayPayment() {
    const paymentRequest = {
        countryCode: 'US',
        currencyCode: 'EUR',
        merchantCapabilities: ['supports3DS'],
        supportedNetworks: ['visa', 'masterCard'],
        total: { label: 'Your Company', amount: '99.99', type: 'final' }
    };
    
    const session = new ApplePaySession(3, paymentRequest);
    
    // Merchant Validation
    session.onvalidatemerchant = async (event) => {
        const resp = await fetch('https://server-to-server.getmondo.co/payment/apple_pay_validate_merchant.php', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                validationURL: event.validationURL,
                company_account_id: 'YOUR_ACCOUNT_ID',
                gateway_secret_key: 'YOUR_SECRET_KEY',
                domain_name: 'your-domain.com'  // Required for server-to-server; optional if browser calls directly
            })
        });
        session.completeMerchantValidation(await resp.json());
    };
    
    // Payment Authorization - Apple provides ENCRYPTED token in event.payment.token
    // IMPORTANT: Pass the token directly to MONDO - do NOT attempt to decrypt it
    session.onpaymentauthorized = async (event) => {
        const resp = await fetch('https://server-to-server.getmondo.co/payment/', {
            method: 'POST',
            headers: { 'Content-Type': 'application/json' },
            body: JSON.stringify({
                company_account_id: 'YOUR_ACCOUNT_ID',
                gateway_secret_key: 'YOUR_SECRET_KEY',
                apple_pay_token: event.payment.token,  // Encrypted token - MONDO decrypts
                transaction_amount: '99.99',
                transaction_currency_iso3: 'EUR',
                cardholder_email_address: 'customer@example.com',
                partner_return_url_completed: 'https://yoursite.com/success',
                partner_return_url_rejected: 'https://yoursite.com/failed',
                live_or_sandbox: 'live'
            })
        });
        
        const result = await resp.json();
        if (result.transaction_status === 'COMPLETED') {
            session.completePayment(ApplePaySession.STATUS_SUCCESS);
            // Payment already processed - redirect is optional for user experience
            if (result.redirect_url) {
                window.location.href = result.redirect_url;
            }
        } else {
            session.completePayment(ApplePaySession.STATUS_FAILURE);
            if (result.redirect_url) {
                window.location.href = result.redirect_url;
            }
        }
    };
    
    session.begin();
}

📋 المتطلبات الأساسية

• ✓ معرف حساب الشريك - معرف حسابك الفريد في MONDO
• ✓ مفتاح الشريك السري - مفتاح مصادقة API الخاص بك

🔄 تدفق الدفع

🔗 اختر طريقة التكامل

{
    "company_account_id": "your_account_id",
    "gateway_secret_key": "your_secret_key",
    "transaction_amount": "99.99",
    "transaction_currency_iso3": "EUR",
    "cardholder_email_address": "customer@example.com",
    "payment_method": "APPLEPAY",
    "partner_session_id": "ORDER-12345",
    "partner_return_url_completed": "https://yoursite.com/success",
    "partner_return_url_rejected": "https://yoursite.com/failed",
    "partner_webhook_url": "https://yoursite.com/webhook",
    "live_or_sandbox": "live"
}

{
    "partner_session_id": "ORDER-12345",
    "gateway_session_id": "73d68b79579eeaa4a1f35f667509ba19",
    "transaction_id": "37819a4707f3736b6fb42148d98f05ab",
    "redirect_url": "https://server-to-server.getmondo.co/applepay/hosted_applepay_button.php?gateway_session_id=73d68b79579eeaa4a1f35f667509ba19",
    "gateway_datetime": "2026-01-28 19:15:00",
    "transaction_status": "INITIATED",
    "gateway_message": "Wallet payment session created - redirect customer to complete payment",
    "payment_method": "APPLEPAY"
}