Skip to main content
Version: v2

Transaction Management

Overview

Transaction Management in a Split Tender payment context refers to the system's ability to handle, track, and manage payment transactions that use multiple payment methods. This document outlines the permissions and restrictions for key transaction operations (capture, cancel, refund) based on payment method combinations and transaction states.

Capture Restrictions

Transaction capture refers to the process of finalizing a previously authorized payment for settlement.

CAPTURE TRANSACTION RESTRICTIONS
Payment Status
  • Parent Payment Status should be AUTHORIZED to initiate capture transaction
Transaction TypePayment MethodsMerchantCCGCondition
SaleAnyCCG automatically captures sale transactions
Pre-AUTHAnyMerchant must explicitly capture pre-auth transactions

Cancel Restrictions

Transaction cancellation refers to stopping a transaction that has been initiated but not yet settled. Different payment method combinations have specific rules for cancellation.

CANCEL TRANSACTION RESTRICTIONS
Payment Status
  • Parent Payment Status should be AUTHORIZED or ACCEPTED to initiate capture transaction
Transaction TypePayment MethodsMerchantCCGCondition
SaleCard + CardOnly CCG can cancel sale transactions with cards
SaleACH + ACHMerchant Initiated: Only if both ACH transactions are in ACCEPTED status.
CCG Initiated: No status dependency for roll back process
SaleCard + ACHMerchants are not allowed to cancel sale transactions with mixed payment methods
Pre-AUTHCard + CardMerchants can cancel pre-authorization transactions

Refund Restrictions

Refunds are the process of returning funds to a customer after a COMPLETED transaction. Refund capabilities depend on the payment status and methods used.

REFUND TRANSACTION RESTRICTIONS
Payment StatusPayment MethodsMerchantCCGCondition
PENDINGAnyIf any payment method is in FAILURE status, CCG issues refund as part of rolling back
PENDINGAnyIf any payment is pending under a split tender transaction
✅ COMPLETEDAnyOnly merchants can initiate refunds for ✅ COMPLETED transactions

Ambiguous Payment Status

STRIPE DASHBOARD INITIATED OPERATIONS

The Mixed payment method status scenarios only occur when captures or cancellations are initiated directly from the Stripe dashboard rather than through the CCG platform. In these cases, CCG is responsible for maintaining transaction integrity.

Transaction Integrity Impacts: Merchant-initiated transaction operations have significant implications for transaction integrity within the system. Since these operations can modify the state of financial transactions, they must be carefully controlled and monitored through the CCG platform rather than directly in Stripe.

Mixed Payment State Scenarios

Mixed Payment State Scenarios
Reconcilation Process
  • CCG Responsibility: When a capture or cancellation event is received from Stripe (initiated from the Stripe dashboard), CCG will automatically initiate RollBack Process to maintain integrity. Merchants do not need to take any action in these scenarios.
  • No Merchant Handling: Merchants are not required to handle refunds or reconciliation for Ambiguous status split tender transactions resulting from Stripe dashboard operations. CCG will process all necessary refunds and actions.

COMPLETED Vs FAILED/CANCELLED COMBINATIONS

Use Cases
ScenarioPayment Method 1Payment 1 StatusPayment Method 2Payment 2 StatusCCG ActionPayment 2 Status After CCG ActionFinal Transaction Status
1CARD🚫 CANCELLED (via Stripe)ACH✅ COMPLETEDCCG automatically issues refund for ✅ COMPLETED ACH payment💰 COMPLETED🚫 CANCELLED
2CARD✅ COMPLETED (captured via Stripe)ACH❌ FAILEDCCG issue refund for ✅ COMPLETED CARD payment if required❌ FAILED❌ FAILED
3ACH🚫 CANCELLED (via Stripe)ACH✅ COMPLETEDCCG automatically issues refund for ✅ COMPLETED ACH payment💰 COMPLETED🚫 CANCELLED
4CARD🚫 CANCELLED (via Stripe)CARD✅ COMPLETED (captured via Stripe)CCG automatically issues refund for ✅ COMPLETED CARD payment💰 COMPLETED🚫 CANCELLED

ACCEPTED/AUTHORIZED Vs FAILED COMBINATIONS

Use Cases
ScenarioPayment Method 1Payment 1 StatusPayment Method 2Payment 2 StatusCCG ActionPayment 2 Status After CCG ActionFinal Transaction Status
5CARD🚫 CANCELLED (via Stripe)ACH⏳ ACCEPTEDCCG automatically initiates cancel on PENDING ACH payment🚫 CANCELLED🚫 CANCELLED
6CARD🚫 CANCELLED (via Stripe)ACH⏳ ACCEPTEDCCG automatically initiates cancel on PENDING ACH payment but cancellation failed🚫 CANCEL_FAILED🚫 CANCEL_FAILED
7CARD🚫 CANCELLED (via Stripe)ACH❌ FAILEDNo additional action needed❌ FAILED❌ FAILED
8ACH🚫 CANCELLED (via Stripe)ACH❌ FAILEDNo additional action needed❌ FAILED❌ FAILED
9CARD🚫 CANCELLED (via Stripe)CARD✅ AUTHORIZEDCCG automatically initiates cancel on AUTHORIZED CARD payment🚫 CANCELLED🚫 CANCELLED

COMPLETED Vs ACCEPTED/PENDING/AUTHORIZED COMBINATIONS

Use Cases
ScenarioPayment Method 1Payment 1 StatusPayment Method 2Payment 2 StatusCCG ActionPayment 2 Status After CCG ActionFinal Transaction Status
10CARD✅ COMPLETED (captured via Stripe)CARD✅ AUTHORIZEDCCG automatically initiates capture on AUTHORIZED CARD payment✅ COMPLETED✅ COMPLETED
11CARD✅ COMPLETED (captured via Stripe)CARDPENDINGCCG wait for capturable state and initiates capture on AUTHORIZED CARD payment✅ COMPLETED✅ COMPLETED
12ACH✅ COMPLETEDACHACCEPTEDCCG wait for ACH Final Event and Then send notification if Success✅ COMPLETED✅ COMPLETED

Handling Guidelines for Mixed Status Transactions

  1. Stripe Dashboard Operations: These mixed status scenarios occur exclusively when captures or cancellations are initiated directly from the Stripe dashboard instead of through CCG.
  2. CCG Automated Handling: Upon receiving a capture or cancellation event from Stripe, CCG will automatically issue refunds or take necessary actions on the other payment method to maintain transaction integrity. No merchant intervention is required.
  3. Merchant Responsibilities:
    • Avoid initiating captures or cancellations directly from Stripe dashboard
    • Monitor split tender transactions for mixed status scenarios only for informational purposes
    • Split Payments in Stripe will have a flag to indicate the same through metadata.