Installation

go mod init

import ("github.com/stripe/stripe-go/v72""github.com/stripe/stripe-go/v72/customer")

go get -u github.com/stripe/stripe-go/v72

Documentation

Customers

params:=&stripe.CustomerParams{Description:stripe.String("Stripe Developer"),Email:stripe.String("gostripe@stripe.com"),}customer,err:=customer.New(params)

PaymentIntents

params:=&stripe.PaymentIntentListParams{Customer:stripe.String(customer.ID),}// set this so you can easily retry your request in case of a timeoutparams.Params.IdempotencyKey=stripe.NewIdempotencyKey()i:=paymentintent.List(params)fori.Next() {pi:=i.PaymentIntent()}iferr:=i.Err();err!=nil {// handle}

Events

i:=event.List(nil)fori.Next() {e:=i.Event()// access event data via e.GetObjectValue("resource_name_based_on_type", "resource_property_name")// alternatively you can access values via e.Data.Object["resource_name_based_on_type"].(map[string]interface{})["resource_property_name"]// access previous attributes via e.GetPreviousValue("resource_name_based_on_type", "resource_property_name")// alternatively you can access values via e.Data.PrevPreviousAttributes["resource_name_based_on_type"].(map[string]interface{})["resource_property_name"]}

Authentication with Connect

// For a list requestlistParams:=&stripe.CustomerListParams{}listParams.SetStripeAccount("acct_123")

// For any other kind of requestparams:=&stripe.CustomerParams{}params.SetStripeAccount("acct_123")

import ("github.com/stripe/stripe-go/v72""github.com/stripe/stripe-go/v72/client")stripe:=&client.API{}stripe.Init("access_token",nil)

Google AppEngine

import ("fmt""net/http""google.golang.org/appengine""google.golang.org/appengine/urlfetch""github.com/stripe/stripe-go/v72""github.com/stripe/stripe-go/v72/client")funchandler(w http.ResponseWriter,r*http.Request) {c:=appengine.NewContext(r)httpClient:=urlfetch.Client(c)sc:=stripeClient.New("sk_test_123",stripe.NewBackends(httpClient))params:=&stripe.CustomerParams{Description:stripe.String("Stripe Developer"),Email:stripe.String("gostripe@stripe.com"),        }customer,err:=sc.Customers.New(params)iferr!=nil {fmt.Fprintf(w,"Could not create customer: %v",err)        }fmt.Fprintf(w,"Customer created: %v",customer.ID)}

Usage

Without a Client

import ("github.com/stripe/stripe-go/v72""github.com/stripe/stripe-go/v72/$resource$")// Setupstripe.Key="sk_key"stripe.SetBackend("api",backend)// optional, useful for mocking// Create$resource$,err:= $resource$.New(stripe.$Resource$Params)// Get$resource$,err:= $resource$.Get(id, stripe.$Resource$Params)// Update$resource$,err:= $resource$.Update(stripe.$Resource$Params)// DeleteresourceDeleted,err:= $resource$.Del(id, stripe.$Resource$Params)// Listi:= $resource$.List(stripe.$Resource$ListParams)fori.Next() {$resource$:= i.$Resource$()}iferr:=i.Err();err!=nil {// handle}

With a Client

import ("github.com/stripe/stripe-go/v72""github.com/stripe/stripe-go/v72/client")// Setupsc:=&client.API{}sc.Init("sk_key",nil)// the second parameter overrides the backends used if needed for mocking// Create$resource$,err:= sc.$Resource$s.New(stripe.$Resource$Params)// Get$resource$,err:= sc.$Resource$s.Get(id, stripe.$Resource$Params)// Update$resource$,err:= sc.$Resource$s.Update(stripe.$Resource$Params)// DeleteresourceDeleted,err:= sc.$Resource$s.Del(id, stripe.$Resource$Params)// Listi:= sc.$Resource$s.List(stripe.$Resource$ListParams)fori.Next() {resource:= i.$Resource$()}iferr:=i.Err();err!=nil {// handle}

Accessing the Last Response

coupon,err:= coupon.New(...)requestID:=coupon.LastResponse.RequestID

it:= coupon.List(...)forit.Next() {// Last response *NOT* on the individual iterator objectit.Coupon().LastResponse// wrong// But rather on the list object, also accessible through the iteratorrequestID:=it.CouponList().LastResponse.RequestID}

Automatic Retries

import ("github.com/stripe/stripe-go/v72""github.com/stripe/stripe-go/v72/client")config:=&stripe.BackendConfig{MaxNetworkRetries:stripe.Int64(0),// Zero retries}sc:=&client.API{}sc.Init("sk_key",&stripe.Backends{API:stripe.GetBackendWithConfig(stripe.APIBackend,config),Uploads:stripe.GetBackendWithConfig(stripe.UploadsBackend,config),})coupon,err:=sc.Coupons.New(...)

Configuring Logging

stripe.DefaultLeveledLogger=&stripe.LeveledLogger{Level:stripe.LevelInfo,}

config:=&stripe.BackendConfig{LeveledLogger:&stripe.LeveledLogger{Level:stripe.LevelInfo,    },}

typeLeveledLoggerInterfaceinterface {Debugf(formatstring,v...interface{})Errorf(formatstring,v...interface{})Infof(formatstring,v...interface{})Warnf(formatstring,v...interface{})}

Expanding Objects

//// *Without* expansion//c,_:=charge.Retrieve("ch_123",nil)c.Customer.ID// Only ID is populatedc.Customer.Name// All other fields are always empty//// With expansion//p:=&CustomerParams{}p.AddExpand("customer")c,_:=charge.Retrieve("ch_123",p)c.Customer.ID// ID is still availablec.Customer.Name// Name is now also available (if it had a value)

Writing a Plugin

stripe.SetAppInfo(&stripe.AppInfo{Name:"MyAwesomePlugin",URL:"https://myawesomeplugin.info",Version:"1.2.34",})

Request latency telemetry

config:=&stripe.BackendConfig{EnableTelemetry:stripe.Bool(false),}

Development

Test

github.com/stretchr/testify/require

go get -t -v

go get -u github.com/stripe/stripe-mockstripe-mock

make test

go test ./invoice

go test ./invoice -run TestInvoiceGet