feat(api): Add idempotency key to cards POST and PATCH endpoints

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 176
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-6e800837b020104545778d65b7b16bae277e6667d98044e83f3bfeacebdb489b.yml
-openapi_spec_hash: 94788968e119e8665a1b0d4742565984
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/lithic%2Flithic-eeeb62a4869ba1436c9252f9630006a829695178e86305aea232f6be0d1e3d81.yml
+openapi_spec_hash: 25bf9c499cd22240949862e622c534f2
 config_hash: 2af43c32faa12490c9c9caa2ce62bccb

api.md

@@ -196,7 +196,7 @@ Response Types:
 
 Methods:
 
-- <code title="post /v1/cards">client.Cards.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardService.New">New</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardNewParams">CardNewParams</a>) (<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#Card">Card</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="post /v1/cards">client.Cards.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardService.New">New</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, params <a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardNewParams">CardNewParams</a>) (<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#Card">Card</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="get /v1/cards/{card_token}">client.Cards.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, cardToken <a href="https://pkg.go.dev/builtin#string">string</a>) (<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#Card">Card</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="patch /v1/cards/{card_token}">client.Cards.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardService.Update">Update</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, cardToken <a href="https://pkg.go.dev/builtin#string">string</a>, body <a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardUpdateParams">CardUpdateParams</a>) (<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#Card">Card</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="get /v1/cards">client.Cards.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, query <a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#CardListParams">CardListParams</a>) (<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go/packages/pagination">pagination</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go/packages/pagination#CursorPage">CursorPage</a>[<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go">lithic</a>.<a href="https://pkg.go.dev/github.com/lithic-com/lithic-go#NonPCICard">NonPCICard</a>], <a href="https://pkg.go.dev/builtin#error">error</a>)</code>

card.go

@@ -50,10 +50,13 @@ func NewCardService(opts ...option.RequestOption) (r *CardService) {
 
 // Create a new virtual or physical card. Parameters `shipping_address` and
 // `product_id` only apply to physical cards.
-func (r *CardService) New(ctx context.Context, body CardNewParams, opts ...option.RequestOption) (res *Card, err error) {
+func (r *CardService) New(ctx context.Context, params CardNewParams, opts ...option.RequestOption) (res *Card, err error) {
+	if params.IdempotencyKey.Present {
+		opts = append(opts, option.WithHeader("Idempotency-Key", fmt.Sprintf("%s", params.IdempotencyKey)))
+	}
 	opts = slices.Concat(r.Options, opts)
 	path := "v1/cards"
-	err = requestconfig.ExecuteNewRequest(ctx, http.MethodPost, path, body, &res, opts...)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodPost, path, params, &res, opts...)
 	return
 }
 
@@ -1294,7 +1297,8 @@ type CardNewParams struct {
 	//     parameters).
 	//   - `PAUSED` - Card will decline authorizations, but can be resumed at a later
 	//     time.
-	State param.Field[CardNewParamsState] `json:"state"`
+	State          param.Field[CardNewParamsState] `json:"state"`
+	IdempotencyKey param.Field[string]             `header:"Idempotency-Key" format:"uuid"`
 }
 
 func (r CardNewParams) MarshalJSON() (data []byte, err error) {

card_test.go

@@ -62,6 +62,7 @@ func TestCardNewWithOptionalParams(t *testing.T) {
 		SpendLimit:         lithic.F(int64(1000)),
 		SpendLimitDuration: lithic.F(lithic.SpendLimitDurationTransaction),
 		State:              lithic.F(lithic.CardNewParamsStateOpen),
+		IdempotencyKey:     lithic.F("65a9dad4-1b60-4686-83fd-65b25078a4b4"),
 	})
 	if err != nil {
 		var apierr *lithic.Error

financialaccount_test.go

@@ -30,7 +30,7 @@ func TestFinancialAccountNewWithOptionalParams(t *testing.T) {
 		Type:           lithic.F(lithic.FinancialAccountNewParamsTypeOperating),
 		AccountToken:   lithic.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
 		IsForBenefitOf: lithic.F(true),
-		IdempotencyKey: lithic.F("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"),
+		IdempotencyKey: lithic.F("65a9dad4-1b60-4686-83fd-65b25078a4b4"),
 	})
 	if err != nil {
 		var apierr *lithic.Error