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"
}