Skip to main content
Version: v2

Enterprise Wallet

Overview​

The Enterprise Wallet in CCG enables merchants to manage enterprise-level customer accounts efficiently. It ensures each enterprise customer is uniquely identified and securely linked to their payment information.

Customer Creation Workflow​

When a merchant initiates a session, the following steps are performed to create or update a CCG customer:

  1. Retrieve Customer Information

    • Call EIMP to obtain customer details. This integration is managed by CCG and is transparent to merchants.
    • Attempt to match the customer to an existing Enterprise ID (EID).

  2. Evaluate EIMP Record

    • No EIMP record found:
      • Create a local customer in CCG.
    • EIMP record found:
      • Customer exists in CCG:
        • Update the customer information in CCG.
        • ⚠️ Limitation: The Customer table enforces a unique index on enterprise ID. If a customer with the same EID exists but is inactive, an exception will occur.
      • Customer does not exist in CCG:
        • Create a new customer and an enterprise wallet in CCG.

Key Considerations​

  • The unique index on enterprise ID ensures that each enterprise customer is created only once in CCG.
  • Handle inactive customers carefully to avoid exceptions during customer creation or updates.
  • Always verify the status of the customer before attempting to create or update records.
  • EIMP integration is handled by CCG; merchants do not need to interact with EIMP directly.
note

Proper error handling and validation are essential to maintain data integrity and prevent duplicate enterprise customers. If EIMP is unavailable or returns errors, ensure fallback logic is in place to handle local customer creation gracefully.