Go-Live Testing Checklist
Before launching your ProBuy integration to production, complete this comprehensive checklist to ensure everything is tested, configured, and ready for real transactions. This checklist covers technical, business, and operational requirements.
Go-Live Phases
- โข Phase 1: Complete sandbox testing
- โข Phase 2: Integration review and approval
- โข Phase 3: Production environment setup
- โข Phase 4: Production verification
- โข Phase 5: Launch and monitoring
Phase 1: Sandbox Testing Checklist
Verify all functionality works correctly in the sandbox environment:
Integration Testing
โ Checkout Creation
Successfully create checkout sessions with all required fields. Verify orderReferenceId uniqueness.
โ Approved Payment Flow
Test complete payment flow using approved test cards. Verify success callback and order fulfillment.
โ Declined Payment Handling
Test all decline scenarios. Verify appropriate error messages shown and orders not fulfilled.
โ Payment Cancellation
Test user cancellation flow. Verify cancel callback works and checkout can be resumed if needed.
โ Deep Link Handling
Test all deep links (success, failure, cancel) redirect correctly back to your app. Verify parameters parsed correctly.
โ Server-Side Verification
Implement and test backend verification of payment status before order fulfillment. Never trust client-side only.
โ Error Handling
Test network errors, timeouts, and API failures. Verify graceful error handling with retry mechanisms.
โ Order Amount Thresholds
Test minimum (300 SAR), standard (1,500 SAR), and high-value orders. Verify installment options shown correctly.
โ Customer Eligibility
Test eligibility checks for different customer profiles (approved, declined, low credit limit).
Mobile-Specific Testing
โ iOS Device Testing
Test on multiple iOS devices (iPhone, iPad) and iOS versions (13.0+). Verify Universal Links work correctly.
โ Android Device Testing
Test on multiple Android devices and versions (API 21+). Verify deep links work correctly.
โ Screen Orientations
Test both portrait and landscape orientations. Verify UI adapts correctly.
โ Background/Foreground Transitions
Test app backgrounding during checkout. Verify state preserved and checkout can resume.
โ Network Connectivity
Test offline scenarios and network switching (WiFi to cellular). Verify appropriate error handling.
Webhook Testing
โ Webhook Endpoint
Webhook endpoint is publicly accessible and returns 200 OK within 5 seconds.
โ Signature Verification
Implement and test HMAC-SHA256 signature verification for all webhook payloads.
โ Event Processing
Test handling of all webhook events: approved, declined, cancelled, refund.processed, etc.
โ Idempotency
Implement idempotent webhook processing. Handle duplicate webhook deliveries gracefully.
โ Retry Mechanism
Test webhook retry logic. Verify failed webhooks are queued and retried appropriately.
Phase 2: Integration Review
Code Review Checklist
โ API Token Security
API tokens stored securely (Keychain/KeyStore, not hardcoded). Environment-based token management implemented.
โ HTTPS Only
All API calls use HTTPS. Certificate pinning implemented for additional security (optional but recommended).
โ Error Logging
Comprehensive error logging implemented. Sensitive data (tokens, PII) excluded from logs.
โ User Experience
Loading indicators, progress feedback, and clear error messages throughout checkout flow.
โ Timeout Handling
Appropriate timeouts set for API calls (30s recommended). Timeout errors handled gracefully.
โ Data Validation
All order data validated before sending to API. Phone numbers, emails, amounts formatted correctly.
Documentation Review
โ Integration Documentation
Internal documentation created for developers. Setup instructions, configuration, and troubleshooting documented.
โ Support Documentation
Customer support team trained on ProBuy. FAQ and troubleshooting guide prepared.
โ Runbook Created
Operations runbook prepared for incident response, monitoring, and escalation procedures.
ProBuy Review Submission
Submit for ProBuy Review
Contact ProBuy integration team with the following information:
- โข Sandbox merchant ID and test checkout IDs
- โข Platform(s): iOS, Android, Web, etc.
- โข Expected transaction volume
- โข Screenshots of integration in sandbox
- โข Webhook endpoint URL for production
- โข Estimated go-live date
Phase 3: Production Setup
Production Access
Production Configuration
โ Production API Token
Received production API token from ProBuy. Token stored securely in production environment.
โ API Endpoints Updated
Production base URL configured: https://api.probuy.dev/v1 (not sandbox URL).
โ Merchant URLs
Production success/failure/cancel URLs configured with correct domain and deep link schemes.
โ Webhook Configuration
Production webhook URL registered with ProBuy. Webhook secret key stored securely.
โ SSL/TLS Certificates
Valid SSL certificates installed for webhook endpoints. Certificates set to auto-renew.
โ Environment Variables
All production environment variables configured. No hardcoded values in code.
Infrastructure Setup
โ Monitoring Setup
Application monitoring (Datadog, New Relic, etc.) configured. ProBuy API metrics tracked.
โ Error Tracking
Error tracking service (Sentry, Bugsnag, etc.) configured. ProBuy-related errors tagged appropriately.
โ Logging Infrastructure
Centralized logging configured (CloudWatch, ELK, etc.). API request/response logs enabled (excluding sensitive data).
โ Alerting Configuration
Alerts configured for checkout failures, API errors, webhook failures, and high decline rates.
โ Database Backup
Automated backups configured for order and transaction data. Backup restoration tested.
โ Scalability Testing
Load testing completed for expected transaction volume. Auto-scaling configured if needed.
Phase 4: Production Verification
Pre-Launch Testing
โ Small Value Test Transaction
Complete ONE real transaction with minimum amount (300 SAR) in production. Verify end-to-end flow works.
โ Webhook Delivery Verified
Confirm production webhook received and processed correctly for test transaction.
โ Order Fulfillment Process
Verify test order processed through your fulfillment system correctly.
โ Refund Test
Process refund for test transaction. Verify refund appears in ProBuy dashboard and your system.
โ Dashboard Access
Team has access to ProBuy production dashboard. Can view orders, transactions, and reports.
โ Monitoring Verification
Confirm all monitoring, logging, and alerting working correctly with production data.
Business Verification
โ Legal Review Complete
Terms of service updated to include ProBuy payment option. Privacy policy reviewed.
โ Marketing Materials
ProBuy branding assets obtained and used correctly. Marketing copy reviewed and approved.
โ Support Training
Customer support team trained on ProBuy features, common issues, and escalation process.
โ Finance System Integration
Finance team prepared for ProBuy transactions, settlements, and reconciliation.
Phase 5: Launch and Monitor
Launch Strategy
โ Soft Launch (Recommended)
Enable ProBuy for limited user segment (10-20%) initially. Monitor for 24-48 hours before full rollout.
โ Feature Flag Configuration
ProBuy payment option controlled via feature flag. Can disable quickly if needed.
โ Rollback Plan
Rollback procedure documented and tested. Team knows how to disable ProBuy if critical issues arise.
โ Communication Plan
Customer communication prepared. Email announcements, in-app messaging, social media posts ready.
Post-Launch Monitoring (First 48 Hours)
Critical Monitoring Period
Key Metrics to Monitor
- โข Checkout creation success rate (>99%)
- โข Payment approval rate (baseline 60-70%)
- โข API error rate (<0.1%)
- โข Webhook delivery success rate (>99%)
- โข Average checkout completion time
- โข Customer support tickets related to ProBuy
Daily Checks
- โข Review ProBuy dashboard for transaction summary
- โข Check error logs for ProBuy-related errors
- โข Verify webhook queue is processing normally
- โข Review customer support tickets
- โข Compare ProBuy conversion vs other payment methods
First Week Review
โ Performance Review
Analyze first week metrics. Compare with expectations and other payment methods.
โ Customer Feedback
Collect and review customer feedback about ProBuy experience. Identify any UX improvements.
โ ProBuy Check-in
Schedule review call with ProBuy team. Discuss launch results and optimization opportunities.
โ Full Rollout
If soft launch successful, complete rollout to 100% of users. Announce broadly.
Emergency Contacts
Production Support
Critical Issues (24/7): +966 11 234 5678
Email Support: [email protected]
Status Page: status.probuy.dev
Response Time SLA: Critical issues < 1 hour | High priority < 4 hours
Congratulations!
Once you've completed this checklist, your ProBuy integration is production-ready. Remember that integration is an ongoing process - continue monitoring, optimizing, and improving the payment experience for your customers.
Ready to Go Live?
Contact our integration team to schedule your production launch and receive your production credentials.
Request Production Access