Better documentation needed on CreateSetupIntent::expand

[JonathanWoollett-Light]

https://stripe.com/docs/api/setup_intents/create does not contain the expand argument that is in CreateSetupIntent.

Current documentation notes:

Specifies which fields in the response should be expanded.

I do not know what this means. In the simplest example, what should the value be?

Additional documentation is needed here.

[arlyon]

No worries!

https://stripe.com/docs/api/setup_intents/object

The SetupIntents object has a number of fields that are not included by default in the response type. You need to expand them manually in requests that return that type to get those fields back. I am not sure why expand is not included in the stripe docs, as it is definitely in their sdk definition which we use to generate the bindings:

jq '.paths["/v1/setup_intents"].post.requestBody.content["application/x-www-form-urlencoded"].encoding.expand' < spec3.sdk.json

You can expand a field by referring to its name in the expand array.

CreateSetupIntent {
  expand: &["customer"],
  ..Default::default()
}