sincecutoff.com
← all changes

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

Check the installed version and the source before using it. Entry JSON

Report a problem with this card