The Commerce Go SDK is a sample library that demonstrates the structure of a Coinbase Commerce driver for the REST APIs.
The Commerce Go SDK sample library is free and open source and released under the Apache License, Version 2.0.
The application and code are only available for demonstration purposes.
To use the Commerce Go SDK, initialize the Credentials struct and create a new client. The Credentials struct is JSON enabled. Ensure that Commerce API credentials are stored in a secure manner.
This code snippet reads the value of the environment variable COMMERCE_API_KEY
to initiate a new Commerce client.
Copy Commerce SDK repository
git clone git@github.com:coinbase-samples/commerce-sdk-go.git
Set the API key as an environment variables in a terminal application
export COMMERCE_API_KEY=<YOUR-COMMERCE-API-KEY>
Initialize the Commerce client with credentials
creds, err := commerce.ReadEnvCredentials("COMMERCE_API_KEY")
if err != nil {
fmt.Printf("Error reading environmental variable: %s", err)
}
client := commerce.NewClient(creds, http.Client{},)
Once a client is initialized, you may call any of the functions. For example, to create a charge,
func main() {
// Initialize credentials struct
creds, err := commerce.ReadEnvCredentials("COMMERCE_API_KEY")
if err != nil {
fmt.Printf("Error reading environmental variable: %s", err)
}
// Initialize client
client := commerce.NewClient(creds, http.Client{})
// Add desired context
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
charge, err := client.CreateCharge(ctx, &commerce.ChargeRequest{
PricingType: "fixed_price",
LocalPrice: &commerce.LocalPrice{
Amount: "1.00",
Currency: "USD",
},
})
if err != nil {
fmt.Printf("error: %s\n", err)
}
// Print the hosted url
fmt.Printf("hosted url: %s\n", charge.Data.HostedURL)
}
The "example" folder will contain the logic to create a charge in the amount of $1.00. To see this in action:
- Change into the 'example' directory by running:
cd example
- Run
go run example.go
Expected output:
created a charge ID: 64e05b38-a938-4620-a9ca-e3b806b3757b
got a hosted url: https://commerce.coinbase.com/charges/EGTHQJXZ
Coinbase Commerce API keys can be created in the Commerce UI under Settings --> Security.