Stripe Charge expansion supports payment_method_details.card.mandate
Introduced 2026-09-30 · score 0.98
HOW TO USE IT
For a Charge on a card payment with an associated mandate, retrieve the Charge with `expand[]=payment_method_details.card.mandate` to include the full Mandate object in the response. Without expansion, the field is the mandate ID when present, or `null`.
curl -G https://api.stripe.com/v1/charges/<CHARGE_ID> \
-u "<YOUR_SECRET_KEY>:" \
-d "expand[]=payment_method_details.card.mandate"WHY THIS HELPS
When retrieving a Charge for a card payment with an associated mandate, include the mandate details in the same API response.
BEFORE THIS CHANGE
Previously, the property returned the mandate ID when present; the release note does not state the prior retrieval procedure.
REQUIREMENTS AND LIMITATIONS
- expand[] = payment_method_details.card.mandate: Expands the card mandate property to its full Mandate object. The release note names this value; Stripe’s expansion guide documents `expand[]` and dot notation for nested expansions.
- CHARGE_ID (required): Placeholder for the Charge identifier in the retrieve URL. The exact retrieve command was not available in the official docs accessed.
- YOUR_SECRET_KEY (required): Placeholder for the Stripe secret API key used for authentication in the documented curl expansion pattern.
- Applies to card payments with an associated mandate.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/endive/2026-09-30/expand-mandate-on-card-payments-details
- https://docs.stripe.com/expand
Check the installed version and the source before using it. Entry JSON