https://github.com/smartpay-co/sdk-go
Smartpay Go SDK
https://github.com/smartpay-co/sdk-go
go golang smartpay smartpay-sdk
Last synced: 10 months ago
JSON representation
Smartpay Go SDK
- Host: GitHub
- URL: https://github.com/smartpay-co/sdk-go
- Owner: smartpay-co
- License: mit
- Created: 2022-05-19T14:01:10.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-24T06:44:49.000Z (about 2 years ago)
- Last Synced: 2025-04-05T17:01:40.482Z (about 1 year ago)
- Topics: go, golang, smartpay, smartpay-sdk
- Language: Go
- Homepage:
- Size: 96.7 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![Go Reference][reference-shield]][reference-url]
[![Go Report Card][go-report-card-shield]][go-report-card-url]
[![Apache 2.0 License][license-shield]][license-url]
[![Workflow][workflow-shield]][workflow-url]
# Smartpay Go SDK
Smartpay Go SDK offers easy access to Smartpay API from applications written in Go.
## Prerequisites
Go v1.18+
## Installation
```shell
go get github.com/smartpay-co/sdk-go
```
## Usage
Let's give a quick example first about how to create a new checkout session.
```golang
package main
import (
"context"
"fmt"
. "github.com/smartpay-co/sdk-go"
)
func main() {
ctx := context.Background()
client, _ := NewClientWithResponses("", "")
checkoutPayload := CreateACheckoutSessionJSONRequestBody{
Currency: CurrencyJPY,
Amount: 350,
Items: []Item{
{Name: "レブロン 18 LOW", Amount: 1000, Currency: CurrencyJPY, Quantity: Ptr(1)},
{Name: "discount", Amount: 100, Currency: CurrencyJPY, Kind: Ptr(LineItemKindDiscount)},
{Name: "tax", Amount: 250, Currency: CurrencyJPY, Kind: Ptr(LineItemKindTax)},
},
ShippingInfo: ShippingInfo{
Address: Address{Country: AddressCountryJP, PostalCode: "123", Locality: "locality", Line1: "line1"},
FeeAmount: Ptr(float32(100)),
FeeCurrency: Ptr(CurrencyJPY),
},
CaptureMethod: Ptr(CaptureMethodManual),
Reference: Ptr("order_ref_1234567"),
SuccessUrl: "https://smartpay.co",
CancelUrl: "https://smartpay.co",
}
result, err := client.CreateACheckoutSessionWithResponse(ctx, checkoutPayload)
if err != nil {
panic(err)
}
fmt.Println(string(result.Body))
}
```
### Initialize A New Client
You need to get your API key to initialize a new client. You can find it on your [dashboard](https://dashboard.smartpay.co/settings/credentials).
You can also customize the client by passing function options into the constructors.
```golang
client, _ := NewClientWithResponses("", WithHTTPClient(&httpClient), WithBaseURL("http://localhost:9000"))
```
### Invoke an API Point
Our clients supprts struct parameters and responses for API calls. In most cases you'll be satisfied with this method. Take the example from above, `CreateACheckoutSessionWithResponse` is so much easier to use with the predefined request and response objects.
But if you want full control for maximium flexibility, then you can use `CreateACheckoutSessionWithBody` and handle the request and response on your own.
This design applies to all our APIs.
## License
Distributed under the MIT License. See `LICENSE.txt` for more information.
[contributors-shield]: https://img.shields.io/github/contributors/smartpay-co/sdk-go.svg
[contributors-url]: https://github.com/smartpay-co/sdk-go/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/smartpay-co/sdk-go.svg
[forks-url]: https://github.com/smartpay-co/sdk-go/network/members
[stars-shield]: https://img.shields.io/github/stars/smartpay-co/sdk-go.svg
[stars-url]: https://github.com/smartpay-co/sdk-go/stargazers
[issues-shield]: https://img.shields.io/github/issues/smartpay-co/sdk-go.svg
[issues-url]: https://github.com/smartpay-co/sdk-go/issues
[license-shield]: https://img.shields.io/github/license/smartpay-co/sdk-go.svg
[license-url]: https://github.com/smartpay-co/sdk-go/blob/main/LICENSE.txt
[reference-shield]: https://pkg.go.dev/badge/github.com/smartpay-co/sdk-go.svg
[reference-url]: https://pkg.go.dev/github.com/smartpay-co/sdk-go
[go-report-card-shield]: https://goreportcard.com/badge/github.com/smartpay-co/sdk-go
[go-report-card-url]: https://goreportcard.com/report/github.com/smartpay-co/sdk-go
[workflow-shield]: https://github.com/smartpay-co/sdk-go/actions/workflows/ci.yml/badge.svg
[workflow-url]: https://github.com/smartpay-co/sdk-go/actions/workflows/ci.yml
