Apple Pay API 文档

📋 先决条件

• ✓ 合作伙伴账户 ID - 您的独特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();
}

📋 先决条件

• ✓ 合作伙伴账户 ID - 您的独特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"
}