Skip to main content
Version: v2

Split Tender Capture

Quick Reference
  • Purpose: Understand CCG's handling of capture requests for split tender payments.
  • Key Scenarios: Complete capture, partial capture, and handling of capture failures.
  • Use: Refer to the table for status mapping and outcome summaries for different capture scenarios.

CCG Split Payment Capture Process

The diagram above illustrates how CCG orchestrates split tender capture requests:

  1. Capture Request: Merchant initiates a capture request for authorized split tender payments
  2. Request Types:
    • Complete capture of both payments
    • Capture of only one payment (with automatic cancellation of the other)
    • Partial amount capture of both payments
  3. Outcome Handling:
    • For successful captures of both payments, status is COMPLETED
    • For temporary failures, CCG retries the capture
    • For permanent failures on one payment, a PARTIAL_SUCCESS status is returned
  4. Merchant Decision Point: When one payment capture fails permanently, merchants must decide whether to refund the successful payment

This approach ensures that split tender captures are handled with appropriate atomicity while providing flexibility for partial capture scenarios.


Key Split Tender Capture Scenarios

ScenarioDescriptionFinal Outcome
1Full Capture: Both payments captured successfullyCOMPLETED
2Single Payment Capture: Only one payment captured, other cancelledCOMPLETED
3Partial Amount Capture: Both payments captured with partial amountsCOMPLETED
4Capture Retry: One payment capture fails with 5XX error - CCG retriesCOMPLETED after retry
5Permanent Capture Failure: One payment capture fails permanentlyPARTIAL_SUCCESS (merchant decision required)

Handling Split Tender Captures

CCG Split Tender Capture Handling
#ScenarioPayment
Methods
Initial StatusMerchant RequestCapture StatusCCG ActionsFinal
Outcome
1Both Payments CapturedCard + CardAUTHORIZEDPayment 1: ✅ REQUESTED
Payment 2: ✅ REQUESTED
Payment 1: ✅ COMPLETED
Payment 2: ✅ COMPLETED
• No additional actions
COMPLETED
2Partial Amount CaptureCard + CardAUTHORIZEDPayment 1: ✅ REQUESTED (partial)
Payment 2: ✅ REQUESTED (partial)
Payment 1: ✅ COMPLETED
Payment 2: ✅ COMPLETED
• No additional actions
COMPLETED
4Permanent Capture FailureCard + CardAUTHORIZEDPayment 1: ✅ REQUESTED
Payment 2: ✅ REQUESTED
Payment 1: ❌ CAPTURE_FAILED
Payment 2: ✅ COMPLETED
• No automatic action⚠️
PARTIAL_SUCCESS
Merchant decides on refund

Split Tender Capture - Flow Scenarios