---
title: Go
slug: sdks/server-sdks/go
excerpt: Pine Labs Server SDK for Go.
hidden: false
sidebar_order: 7
metadata:
  title: Go SDK for Pine Labs Payment Gateway | Official Module
  description: >-
    Official Go SDK for Pine Labs payment APIs. Install pinelabs-go module, authenticate with OAuth2, and integrate payment gateway in Go backends with fully typed operations and models.
  keywords: "Go SDK, Pine Labs Go, golang payment, payment gateway go, go module, backend integration, oauth2 golang"
  robots: index
---
`pinelabs-go` is the official Go SDK for the **Pine Labs Online Payment Gateway** (Plural). It is generated from the same OpenAPI spec that powers this documentation, so every operation, request, and response model is fully typed.



- **Module:** [`github.com/plural-pinelabs/pinelabs-go`](https://github.com/plural-pinelabs/pinelabs-go)
- **Runtime:** Go ≥ 1.13



## Install

```bash
go get github.com/plural-pinelabs/pinelabs-go
```

## Quickstart

The Pine Labs API uses **OAuth2 with the `client_credentials` grant**. Exchange your credentials for an access token, then pass it to `client.NewClient`.

```go
package main

import (
  "context"
  "fmt"
  "os"

  pinelabs "github.com/plural-pinelabs/pinelabs-go"
  pinelabsclient "github.com/plural-pinelabs/pinelabs-go/client"
  "github.com/plural-pinelabs/pinelabs-go/option"
)



func main() {
  ctx := context.Background()
  baseURL := "https://pluraluat.v2.pinepg.in" // UAT
  // baseURL := "https://api.pluralpay.in"     // Production

  // 1. Get a token (the auth call itself does not need a bearer token)
  auth := pinelabsclient.NewClient(option.WithBaseURL(baseURL))

  tokenResp, err := auth.Authentication.GenerateToken(ctx, &pinelabs.GenerateTokenRequest{
    GrantType:    "client_credentials",
    ClientId:     os.Getenv("PINELABS_CLIENT_ID"),
    ClientSecret: os.Getenv("PINELABS_CLIENT_SECRET"),
  })
  if err != nil {
    panic(err)
  }


  // 2. Build an authenticated client
  client := pinelabsclient.NewClient(
    option.WithBaseURL(baseURL),
    option.WithToken(tokenResp.AccessToken),
  )


  // 3. Call any operation
  order, err := client.Orders.CreateOrder(ctx, &pinelabs.CreateOrderRequest{
    MerchantOrderReference: "order-001",
    OrderAmount: &pinelabs.Amount{
      Value:    pinelabs.Int(50000),
      Currency: pinelabs.String("INR"), // ₹500.00
    },
  })
  if err != nil {
    panic(err)
  }
  fmt.Println(order)
}
```



## Environments



| Environment | Base URL                            |
| ----------- | ----------------------------------- |
| UAT         | `https://pluraluat.v2.pinepg.in`    |
| Production  | `https://api.pluralpay.in`          |



Pass the URL via `option.WithBaseURL()`. The exported `Environments.Production` constant is also available.



## Sub-clients



`Client` exposes one sub-client per API tag. All are initialised when the client is created.



| Sub-client                             | Purpose                                            |
| -------------------------------------- | -------------------------------------------------- |
| `client.Authentication`                | OAuth token generation                             |
| `client.Orders`                        | Create, capture, cancel, and fetch orders          |
| `client.Refunds`                       | Create and look up refunds                         |
| `client.Settlements`                   | Settlement reports + UTR lookup                    |
| `client.Checkout`                      | Hosted-checkout related operations                 |
| `client.PaymentLinks`                  | Single + bulk payment links                        |
| `client.CardPayments`                  | Direct card payment + OTP flow                     |
| `client.Bnpl`                          | Buy-Now-Pay-Later eligibility and flows            |
| `client.ConvenienceFee`                | Convenience-fee config and computation             |
| `client.EChallans`                     | Government e-challan integration                   |
| `client.ApplePay`                      | Apple Pay session + decryption                     |
| `client.InternationalPayments`         | Cross-border (DCC / MCC) payments                  |
| `client.Customers`                     | Customer profile management                        |
| `client.Tokenization`                  | Card / network tokenization                        |
| `client.Payouts`                       | Payouts: balance, create, cancel, list             |
| `client.SubscriptionsPlans`            | Recurring-billing plans                            |
| `client.SubscriptionsSubscriptions`    | Subscription lifecycle                             |
| `client.SubscriptionsPresentations`    | Subscription debit presentations                   |
| `client.PayByPoints`                   | Loyalty / points-based payments                    |
| `client.AffordabilitySuite`            | EMI / offer eligibility                            |
| `client.SplitSettlements`              | Split settlements between sub-merchants            |



For the full operation list and request/response schemas, see the [API reference](/docs/api-reference).



## Error handling



The SDK returns errors as standard Go `error` values. Use type assertions to inspect HTTP-level details:



```go
order, err := client.Orders.GetOrderById(ctx, &pinelabs.GetOrderByIdRequest{
  OrderId: "missing",
})
if err != nil {
  fmt.Fprintf(os.Stderr, "error: %v\n", err)
  return
}
```



## Request options



Every operation accepts variadic `option.RequestOption` arguments for per-call overrides:



```go
order, err := client.Orders.CreateOrder(
  ctx,
  &pinelabs.CreateOrderRequest{ /* ... */ },
  option.WithMaxAttempts(1),
)
```



## Source & support



- GitHub: [github.com/plural-pinelabs/pinelabs-go](https://github.com/plural-pinelabs/pinelabs-go)
- API reference: [/docs/api-reference](/docs/api-reference)