ProBuy Logo
PB

ProBuy Docs

Version 1.0

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.

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
Request Integration Review

Phase 3: Production Setup

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)

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

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

Additional Resources