Most requests to the Commerce API must be authenticated with an API key. You can create an API key in your Settings page after creating a Coinbase Commerce account.
go get -v github.com/rizalgowandy/coinbase-commerce-gopackage main
import (
"context"
"log"
"github.com/rizalgowandy/coinbase-commerce-go"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/api"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/entity"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/enum"
)
func main() {
client, err := coinbase.NewClient(api.Config{
Key: "REPLACE_WITH_YOUR_API_KEY",
Timeout: 0, // Default: 1 min.
RetryCount: 0, // Default: 0 = disable.
RetryMaxWaitTime: 0, // Default: 2 secs.
Debug: true, // Turn on on development for easier debugging.
})
if err != nil {
log.Fatal(err)
}
// Create a charge.
createResp, err := client.CreateCharge(context.Background(), &entity.CreateChargeReq{
Name: "The Sovereign Individual",
Description: "Mastering the Transition to the Information Age",
LocalPrice: entity.CreateChargePrice{
Amount: "100.00",
Currency: "USD",
},
PricingType: enum.PricingTypeFixedPrice,
Metadata: entity.CreateChargeMetadata{
CustomerID: "id_1005",
CustomerName: "Satoshi Nakamoto",
},
RedirectURL: "https://charge/completed/page",
CancelURL: "https://charge/canceled/page",
})
if err != nil {
log.Fatal(err)
}
log.Printf("%+v", createResp)
// Show a charge by providing either the code or id.
showResp, err := client.ShowCharge(context.Background(), &entity.ShowChargeReq{
ChargeCode: createResp.Data.Code,
ChargeID: "",
})
if err != nil {
log.Fatal(err)
}
log.Printf("%+v", showResp)
}For more example check here.
Sometime it's make sense to make an API call without actually calling the API. In order to support that this library has a built-in stub that can be triggered. You can enable stub by injecting certain value to the context data. You can also enforce that certain API call will always return error with specific type and message.
package main
import (
"context"
"log"
"github.com/rizalgowandy/coinbase-commerce-go"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/api"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/entity"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/enum"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/api/stub"
)
func AlwaysSuccess(ctx context.Context, client *coinbase.Client) {
// Enable stub that always success and return data.
ctx = stub.Enable(ctx)
// Call any client method.
resp, err := client.CreateCharge(ctx, &entity.CreateChargeReq{})
if err != nil {
log.Fatal(err)
}
log.Printf("%+v", resp)
}
func AlwaysError(ctx context.Context, client *coinbase.Client) {
// Enable stub that always error and return specific error.
ctx = stub.SetErrDetailResp(context.Background(), entity.ErrDetailResp{
Type: "bad_request",
Message: "stub: error triggered",
})
// Call any client method.
resp, err := client.CreateCharge(ctx, &entity.CreateChargeReq{})
if err != nil {
log.Fatal(err)
}
log.Printf("%+v", resp)
}For more example, check here.
Webhooks make it easier to integrate with Coinbase Commerce by allowing you to subscribe to a set of charge events. In a sense webhook is basically callback to notify our app after a change of state in resource such as charges. Just like before, you can enable that by injecting certain value to the context.
package main
import (
"context"
"log"
"github.com/rizalgowandy/coinbase-commerce-go"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/api"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/entity"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/enum"
"github.com/rizalgowandy/coinbase-commerce-go/pkg/api/stub"
)
func SendWebhook(ctx context.Context, client *coinbase.Cliet) {
// Enable stub that will send webhook after certain times.
ctx := stub.SetWebhookReq(context.Background(), &entity.WebhookReq{
URL: "http://127.0.0.1:9000/test",
SharedSecretKey: "WEBHOOK_SECRET_KEY",
Resource: stub.CreateWebhooksResource(),
})
resp, err := client.CreateCharge(ctx, &entity.CreateChargeReq{})
if err != nil {
log.Fatal(err)
}
log.Printf("%+v", resp)
}For more example, check here.
Version: 2018-03-22
