Skip to main content

PayPro Global Technical Integration Documentation

Introduction​

PayPro Global provides a comprehensive Merchant-of-Record (MoR) solution specifically designed for mobile apps and SaaS platforms seeking to expand beyond traditional app store ecosystems. As your MoR, we handle the complete payment lifecycle, including processing, tax compliance, invoicing, chargeback management, and customer support.

MoR Flow

Key Value Propositions

  • Cost Efficiency: Single transparent fee structure with higher revenue retention compared to app commissions between 15-30%
  • Global Compliance: Automated VAT/GST calculation, invoicing, and tax remittance across 140+ currencies
  • Payment Flexibility: Support for 70+ payment methods, including cards, digital wallets, and local APMs
  • Immediate Access: Real-time product delivery via hosted checkout flows
  • Subscription Control: Complete lifecycle management, including trials, proration, dunning, and billing flexibility

Architecture Overview​

System Components

System Components

Data Flow

  1. Initiation: Customer initiates purchase in your application
  2. Checkout: Secure redirect to PayPro Global embedded checkout
  3. Processing: Payment processed through PCI-compliant infrastructure
  4. Notification: Real-time webhook notifications sent to your servers
  5. Fulfillment: Your application grants access based on webhook verification
  6. Compliance: Automated tax handling, invoicing, and regulatory compliance

Integration Approaches: Choose Your Path​

1. Quick Integration: Hosted Checkout in WebView

Perfect for: Fast launches, limited development resources, proven conversion flows

The fastest path to market involves integrating PayPro Global's hosted checkout directly into your app via WebView or system browser. This approach requires minimal code changes while providing a secure, compliant payment experience.

How it works:

  1. Customer taps "Buy" or "Subscribe" in your app
  2. PayPro Global's secure checkout opens seamlessly in WebView
  3. Customer completes payment using their preferred method
  4. We process payment, handle taxes, and issue invoices automatically
  5. Webhook notifications trigger immediate access in your app

Key advantages:

  • Zero PCI compliance burden - We handle all sensitive payment data
  • Minimal development time - Integration possible in hours, not weeks
  • Maximum conversion rates - Checkout optimized for mobile
  • Instant compliance - Global tax handling and regulatory requirements covered
  • Immediate deployment - No complex SDK integrations or extensive testing required

2. Custom Checkout: API-Driven Integration

Perfect for: Advanced customization, complex pricing models, branded experiences

For apps requiring complete control over the user experience, our Checkout API enables fully customized payment flows while maintaining our compliance and processing benefits.

Advanced capabilities:

  • Dynamic pricing engine - Real-time price calculation based on location, currency, or customer segments
  • Subscription mastery - Complex billing cycles, proration logic, dunning management, and upgrade/downgrade flows
  • Brand integration - Smooth checkout that matches your app's design and user experience
  • Business logic flexibility - Custom validation, promotional codes, and conditional offers

Implementation workflow:

  1. Your app initiates a purchase request to your backend
  2. Backend calls PayPro Global API to create a secure transaction
  3. Customized checkout experience launches within your app
  4. Payment processing and compliance are handled automatically
  5. Real-time webhooks enable instant access provisioning

3. Hybrid Approach: Best of Both Worlds

Perfect for: Balanced development effort with enhanced control

Combine the speed of hosted checkout with custom verification logic for a solution that provides both rapid implementation and business flexibility.

Technical Infrastructure​

Webhook-Driven Architecture

Our real-time webhook system ensures your app responds instantly to payment events:

OrderCharged - Grant immediate access when payment succeeds
SubscriptionChargeSucceeded - Handle recurring billing automatically
SubscriptionChargeFailed - Implement dunning and retry logic
OrderRefunded - Process refunds and access revocation
OrderChargedBack - Manage disputes and chargebacks

Security & Compliance Built-In

  • PCI DSS Level 1 compliance - Enterprise-grade payment security
  • Global tax automation - VAT/GST calculation and remittance in 60+ countries
  • GDPR compliance - Privacy-first data handling and customer rights management
  • Fraud prevention - Advanced risk assessment and transaction monitoring

User Experience

  1. Loading States: Show clear loading indicators during checkout
  2. Error Messages: Provide user-friendly error messages
  3. Mobile Optimization: Ensure checkout works on all devices
  4. Accessibility: Follow WCAG guidelines for accessibility
User Experience

Support & Resources

Getting Started:​

Phase 1: Setup

  • Create a PayPro Global merchant account
  • Configure products and pricing in the control panel
  • Access your account in a test mode environment for testing

Phase 2: Integration

  • Choose an integration approach based on your requirements
  • Implement checkout flow using our documentation and samples
  • Set up webhook endpoints for real-time notifications

Phase 3: Testing

  • Comprehensive testing with various payment methods and scenarios
  • Validate webhook handling and access provisioning
  • Security review and compliance verification

Phase 4: Launch

  • Switch to the production environment with live credentials
  • Monitor transactions and user experience
  • Optimize conversion rates based on real-world data

FAQ​

Q: Can we accept checkout inside the app without using the App Store billing?
A: Yes — open our hosted checkout in a webView or external browser. Ensure you follow the app store policies for in-app payment linking where applicable.

Q: Can I integrate without a backend?
A: While possible for simple use cases, a backend is recommended for webhook handling, security, and access control. Consider serverless functions for lightweight backends.

Q: How long does integration typically take?
A: Simple hosted checkout integration can be completed in 1-2 days. Custom API integration typically takes 1-2 weeks, depending on complexity.

Q: Do you support recurring billing?
A: Yes, PayPro Global fully supports subscription management, including trials, proration, dunning, and billing cycle changes.