#Aarti
maiden grotto
dry flint
By memo, what do you mean exactly?
dense needle
"description" on the invoice
denoted by the description field on the invoice object
dry flint
Got it. There's nothing you can pass in the create Subscription call to propagate a "description" on the Invoice.
If you use collection_method: charge_automatically, you can't update/edit the Subscription's first invoice to add this unless you set a trial
If you create a trial with trial_end a few seconds in the future, the first invoice will be a $0 invoice. The second invoice will have a one hour draft period so you can add the description then
Alternatively, if you use collection_method: send_invoice you have 1 hour before the invoice gets finalized, so you can update the Invoice's description then
dense needle
This is very helpful. Thank you 💯
weary rock
And how and when is description usually added to the invoice ? What is recommended way to do it ?
dry flint
@weary rock not sure I follow. You can make a request to update the Invoice but the Subscription's first Invoice is special (see the above)
weary rock
If I understood correctly,
if collection method = charge_automatically
first invoice can not be updated
but the following invoices can be updated. So I guess the question is what is the recommendation on when to update the following invoices ? on some webhook event ? what event ?
if collection method = send_invoice
These can be updated. Same question, the recommended way to add a description is to listen to a webhook event ? what event ? invoice.created ?
dry flint
Yep, events! You can listen for invoice.created events to know when a new invoice was created. You have ~1 hour before the invoice transitions to finalized (and can no longer be edited)
weary rock
Great, thank you. and this does not apply to first invoice with collection method = charge_automatically. Everything else can be updated ? First invoice with collection method = send invoice , subsequent invoices regardless of collection method ?
dry flint
I don't understand your second question. Can you rephrase?
weary rock
if collection method = charge_automatically and this is subscription's first invoice - it can NOT be updated
if collection method = charge_automatically and this is not first invoice - it can be updated
if collection method = send_invoice and this is subscription's first invoice - it can be updated
if collection method = send_invoice and this is not first invoice - it can be updated
Are those statements true ^^ ?
dry flint
Yep, true!
weary rock
great, thank you for your help. I don't have any other questions