Checking access…

Skip to main content
Version: v2

Getting Started with CCG

The Convenient Checkout Group (CCG) platform enables merchants to accept payments, manage wallets, and embed checkout flows with minimal effort. This guide walks you through everything you need β€” from onboarding prerequisites to choosing the right integration path for your team.

Before you begin

You will need a merchantId from CCG. Complete the Merchant Onboarding process first if you haven't already.

V2 adoption paths

If you are adopting Convenient Checkout V2 β€” either as a new merchant or by migrating from a V1 integration β€” use one of the dedicated paths below rather than the general Getting Started flow:

Your situationWhere to start
Existing V1 CCG integration, moving to V2V1 to V2 Migration Guide
New merchant onboarding directly to V2Direct-to-V2 Onboarding

Note on naming: The Migration section in the left nav (/integration/customer-migration/migration) covers bulk import of existing customer and payment-method records into CCG β€” this is a separate concern from V1 to V2 API adoption. See Why Adopt V2 if you need to evaluate the business case first.


Onboarding & Integration Flow​


🚦 Choose Your Integration Path​

πŸ› οΈ API Integration (Total Control)

Build your own UI from scratch and use our API to power the logic.

  • Best for: Custom mobile apps, unique branding, or complex backend workflows
  • Effort: High β€” backend & frontend dev required
  • Customization: Full β€” every pixel is yours
Explore API Reference β†’

⚑ UI Components (Fast & Secure)

Drop our pre-built, optimized components into your app with a few lines of code.

  • Best for: Standard checkouts, fast go-to-market, automatic security compliance
  • Effort: Low β€” mostly frontend copy-paste
  • Customization: Limited β€” themed to your brand
View UI Components β†’
Not sure which to pick?

If you want the fastest path to production, start with UI Components. If you need deep customization or are building a custom app, choose API Integration.


Onboarding Checklist​

βœ… Required​

These steps must be completed before you can process payments.

StepOwnerDescription
HCP ConfigurationHCPRegister your organization with the HealthSafePay Cloud Platform to enable CCG services.
Stripe ConfigurationStripeSet up Stripe as the payment processor for your merchant account.
Merchant OnboardingCCGRegister your merchant details and enable payment capabilities.

βš™οΈ Optional​

These steps unlock additional features and can be completed at any time.

StepOwnerDescription
Report ConfigurationCCGConfigure reporting for transaction and payout insights.
Webhooks ConfigurationCCGSet up webhooks to receive real-time event notifications.
Wallet Payment Set UpCCGEnable Google Pay and Apple Pay for your customers.
Enterprise Wallet ConfigurationCCGConfigure enterprise wallet settings if required.

Next Steps​

Once you've completed the required onboarding steps above, follow the path that fits your integration:

If you chose UI Components (Widget):

  1. Set up your first session β€” create a session from your backend
  2. Integrate the widget β€” choose hosted, embedded, or express checkout
  3. Explore widget capabilities β€” payment, wallet, add method, and more

If you chose API Integration:

  1. Review the API Reference β€” explore endpoints and data models
  2. Configure Webhooks β€” reports, webhooks, and more