stripe / stripe-node

Node.js library for the Stripe API.
https://stripe.com
MIT License
3.73k stars 728 forks source link

Support for `footer` in `invoice_settings` #2091

Closed andreialecu closed 1 month ago

andreialecu commented 1 month ago

Is your feature request related to a problem? Please describe.

I'm not sure if this is a bug in this library or lack of support in the underlying API, but there doesn't seem to be a way to programatically define the footer for invoices that are sent by subscriptions.

This is possible to do via the web admin: CleanShot 2024-05-17 at 12 00 49@2x

Describe the solution you'd like

 await this.stripeUtilsService.stripe.subscriptionSchedules.create({
          default_settings: {
            collection_method: 'send_invoice',
            invoice_settings: {
              days_until_due: 7,
              footer: 'test123', // this should be possible
            } ,
          },

Describe alternatives you've considered

I suppose it may be possible to look for the pending invoice and update it?

Not clear how to do this otherwise.

Additional context

The documentation doesn't specify any way to set up a footer: https://docs.stripe.com/api/subscription_schedules/create

Same for other fields that may be missing. Also not just subscriptionSchedules are affected, but subscriptions too.

andreialecu commented 1 month ago

I believe this actually exists just that it isn't documented anywhere.

I inspected the POST request that the web admin does to update the field, and I see that it does indeed pass a footer in invoice_settings.

Edit: Indeed, I can confirm this is the case. It also shows in the logs:

CleanShot 2024-05-17 at 12 37 02@2x

remi-stripe commented 1 month ago

Hello! This feature is currently only available to the Dashboard and can't be used in the API which is why you don't see it documented. It's on our list of feature requests but hasn't made it up to the top of the list just yet.

I'm going to close this issue as your ask is more an API feature request and is better directed to our support team who can help track the asks. You can contact them here: https://support.stripe.com/contact