Skip to content

    Apple Pay Test Portal

    Prerequisites

    Before using the portal, ensure you have:

    • Valid Netaxept merchant credentials

    • Apple Pay merchant certificate properly configured in your Netaxept account

    • Apple Pay merchant ID from Apple Developer Console

    • Test payment tokens (for decryption testing)

    Overview

    The Apple Pay Test Portal is a comprehensive testing and validation tool designed specifically for merchants integrating Apple Pay payments through the Netaxept system. This portal provides essential functionality to test, validate, and troubleshoot your Apple Pay integration before going live.

    Getting Started

    Accessing the Portal

    Navigate to the right Apple Pay Test Portal:

    Test Portal Features

    The portal is organised into three main sections:

    1. 🛒 Transaction Setup

    This section allows you to register and process Apple Pay transactions for testing.

    How to Use:

    • Enter Merchant ID: Your Netaxept merchant identifier
    • Select Currency: Choose from NOK, SEK, EUR, or DKK
    • Choose Authorization Type:
      • Standard Authorization (default)
      • Pre-Authorization
      • Fuel Transaction
      • Electric Vehicle Charging
    • Click Generate Transaction to create a test transaction
    • Transaction ID will appear automatically for further processing

      Expected Results:

      • Success: Transaction ID displayed (format: TXN_xxxxxxxxx)
      • Error: Error message explaining the issue (e.g., invalid merchant ID, configuration problems)
    • Click on Pay button - it will generate a QR code.
    • Scan it from the mobile to pay and proceed.

    2. 🔓 Apple Pay Decryption

    This section helps you test the decryption of Apple Pay payment tokens.

    How to Use:

    1. Enter Merchant ID: Same as your transaction setup
    2. Select Currency: Must match your certificate configuration
    3. Paste Payment Token: Insert the encrypted Apple Pay payment data

    Expected Results:

    • ✅ Success: Decrypted payment information showing:
      • Card Number (masked)
      • Expiry Date
      • ECI (E-Commerce Indicator)
    • ❌ Error: Specific error messages for troubleshooting

    3. 🔐 Certificate Validation

    This section provides comprehensive validation of your Apple Pay certificates and configuration.

    How to Use:

    1. Enter Merchant ID: Your Netaxept merchant identifier
    2. Select Currency: The currency for which you want to validate certificates
    3. Click Validate Certificate to run comprehensive checks

    Validation Results:

    The system will display detailed certificate information:

    FieldDescriptionGood ValuesWarning Signs
    StatusOverall certificate validity✅ Yes❌ No
    Merchant IDApple Pay merchant identifiermerchant.id.example.comN/A or missing
    Key IDCertificate public key hashBase64 stringUnable to calculate
    IssuerCertificate authorityContains AppleOther authorities
    Valid From/UntilCertificate validity periodCurrent date within rangeExpired dates
    Days RemainingTime until expiration30+ days< 30 days (red warning)
    Apple IssuedVerified Apple certificate✅ Yes❌ No
    Private Key AvailableEC private key present✅ Yes❌ No

    Common Issues and Solutions

    Certificate Problems

    No Apple Pay credentials found

    Solution:

    • Verify if your merchant ID is correct
    • Ensure Apple Pay is configured for your account
    • Contact support to verify certificate installation

    Certificate expired

    Solution:

    • Generate new certificate in Apple Developer Console
    • Upload new certificate through Netaxept merchant portal
    • Update your integration with new certificate

    Private key missing or invalid

    Solution:

    • Ensure private key was properly generated and uploaded
    • Verify EC private key format (PEM with proper headers)
    • Re-generate certificate and private key pair if needed

    Decryption Issues

    Failed to decrypt payment token

    Possible Causes & Solutions:

    • Wrong merchant ID: Use the exact merchant ID from your Apple Developer Console
    • Currency mismatch: Ensure selected currency matches your certificate configuration
    • Invalid token format: Verify the JSON structure matches Apple Pay specifications
    • Certificate issues: Run certificate validation first to identify problems

    Merchant ID mismatch in token

    Solution:

    • Verify the merchant ID in your payment token matches your certificate
    • Ensure you're using the correct Apple Pay merchant ID in your app/website

    Transaction Registration Issues

    Invalid merchant credentials

    Solution:

    • Verify your Netaxept merchant ID is correct
    • Check that your merchant account has Apple Pay enabled
    • Ensure proper API permissions are configured

    Was this helpful?

    What was your feeling about it?