go-paddle
go-paddle is a Go client library for accessing the Paddle API.
Installation
go get github.com/Fakerr/go-paddle
Alternatively the same can be achieved if you use import in a package:
import "github.com/Fakerr/go-paddle"
and run go get without paramters.
Usage
The package paddle comes with two different clients. A client for the Product, Subscription, Alert APIs that will require a vendor_id and a vendor_auth_code and a client for the Checkout API.
The services of a client divide the API into logical chunks and correspond to the structure of the Paddle API documentation at https://developer.paddle.com/api-reference/.
Product API, Subscription API, Alert API
import "github.com/Fakerr/go-paddle/paddle"
Construct a new Paddle client, then use the various services on the client to access different parts of the Paddle API. The client always requires a vendor_id and a vendor_auth_code arguments that you can get from the Paddle dashboard. For example:
client := paddle.NewClient(vendorId, vendorAuthCode, nil)
// List all users subscribed to any of your subscription plans
users, _, err := client.Users.List(context.Background(), nil)
Some API methods have optional parameters that can be passed. For example:
client := paddle.NewClient(vendorId, vendorAuthCode, nil)
// List all users subscribed to any of your subscription plans
opt := &UsersOptions{SubscriptionID: "1"}
users, _, err := client.Users.List(context.Background(), opt)
NOTE: Using the context package, one can easily pass cancelation signals and deadlines to various services of the client for handling a request. In case there is no context available, then context.Background() can be used as a starting point.
For more sample code snippets, head over to the example directory.
Checkout API
import "github.com/Fakerr/go-paddle/paddle"
Construct a new Paddle checkout client, then use the various services on the client to access different parts of the Paddle API.
client := paddle.NewCheckoutClient(nil)
// Retrieve prices for one or multiple products or plans
options := &PricesOptions{CustomerCountry: "tn"}
prices, _, err := client.Prices.Get(context.Background(), "1", options)
Sandbox environment
If you want to send requests against a sandbox environment, the package paddle provides two specific clients for that purpose:
client := paddle.NewSandboxClient(sandboxVendorId, sandboxVendorAuthCode, nil)
or to access the checkout API
client := paddle.NewSandboxCheckoutClient(nil)
Pagination
Some requests for resource collections (users, webhooks, etc.) support pagination. Pagination options are described in the paddle.ListOptions struct and passed to the list methods directly or as an embedded type of a more specific list options struct (for example paddle.UsersOptions).
client := paddle.NewClient(vendorId, vendorAuthCode, nil)
// List all users subscribed to any of your subscription plans
opt := &UsersOptions{
SubscriptionID: "1",
ListOptions: ListOptions{Page: 2},
}
users, _, err := client.Users.List(context.Background(), opt)
Webhooks
go-paddle comes with helper functions in order to facilitate the validatation and parsing of webhook events. For recognized event types, a value of the corresponding struct type will be returned.
Example usage:
func PaddleWebhookHandler(w http.ResponseWriter, r *http.Request) {
payload, err := paddle.ValidatePayload(r, webhookSecretKey)
if err != nil { ... }
alert, err := paddle.ParsePayload(payload)
if err != nil { ... }
switch alert := alert.(type) {
case *paddle.SubscriptionCreatedAlert:
processSubscriptionCreatedAlert(alert)
case *paddle.SubscriptionCanceledAlert:
processSubscriptionCanceledAlert(alert)
...
}
}
Todos
List of Paddle APIs that are not covered yet or are work in progress:
- Licenses
- Transactions
Contributing
Pull requests are welcome, along with any feedback or ideas. The calling pattern is pretty well established, so adding new methods is relatively straightforward.
License
This library is distributed under the MIT-style license found in the LICENSE file.
351 Nov 20, 2022
33 Jan 2, 2023
180 Nov 15, 2022
378 Jan 8, 2023
45 Nov 28, 2022
1.3k Jan 8, 2023
2 Oct 31, 2022
0 Feb 2, 2022
956 Dec 26, 2022
29 May 25, 2021
4 May 22, 2021
5 Nov 14, 2022
12 Oct 13, 2022
17 Nov 13, 2022
3 May 21, 2022
33 Sep 28, 2022
55 Sep 27, 2022
1 Mar 5, 2022
19 Sep 27, 2022
84 Dec 24, 2022
541 Dec 28, 2022
12 Oct 8, 2022
193 Sep 27, 2022
4.8k Dec 30, 2022
456 Dec 24, 2022
166 Aug 27, 2022
134 Jan 8, 2023