🚨 **Primary Error:** TypeError: Cannot read properties of undefined (reading 'client_secret') - invoice.payment_intent is missing
✅ **Resolution:** Read payments through the InvoicePayment object (invoice_payments) instead of invoice.payment_intent / invoice.charge before pinning API version 2025-03-31.basil or later.