Go SDK

The UQPAY Go SDK provides typed access to the UQPAY API, including automatic OAuth2 authentication, automatic idempotency keys, and thread-safe credential management.

GitHub

github.com/uqpay/uqpay-sdk-go

The SDK requires Go 1.19 or higher. Current version: 1.0.3.

Installation

go get github.com/uqpay/uqpay-sdk-go@latest

Quick start

package main

import (
    "context"
    "log"

    "github.com/uqpay/uqpay-sdk-go"
    "github.com/uqpay/uqpay-sdk-go/configuration"
    "github.com/uqpay/uqpay-sdk-go/issuing"
)

func main() {
    client, err := uqpay.NewClient(
        "your-client-id",
        "your-api-key",
        configuration.Sandbox(),
    )
    if err != nil {
        log.Fatal(err)
    }

    ctx := context.Background()

    // Create a cardholder
    cardholder, err := client.Issuing.Cardholders.Create(ctx, &issuing.CreateCardholderRequest{
        Email:       "user@example.com",
        PhoneNumber: "1234567890",
        FirstName:   "John",
        LastName:    "Doe",
        CountryCode: "US",
    })
    if err != nil {
        log.Fatal(err)
    }
    log.Printf("Cardholder ID: %s\n", cardholder.CardholderID)
}

Configuration

Direct parameters
Environment variables
Custom endpoint

// Sandbox (for testing)
client, err := uqpay.NewClient(clientID, apiKey, configuration.Sandbox())

// Production
client, err := uqpay.NewClient(clientID, apiKey, configuration.Production())

export UQPAY_CLIENT_ID="your-client-id"
export UQPAY_API_KEY="your-api-key"

Or create a .env file from the provided template:

cp .env.example .env

client, err := uqpay.NewClient(clientID, apiKey, &configuration.Config{
    BaseURL: "https://custom-api.example.com/api",
})

Authentication

The SDK handles OAuth2 authentication automatically:

Fetches access tokens using client credentials
Caches tokens until expiration
Automatically refreshes expired tokens
Thread-safe token management

Idempotency

Every API request automatically includes a unique idempotency key to ensure safe retries and prevent duplicate operations. You do not need to set this manually.

Error handling

The SDK returns detailed error information including HTTP status codes and API error details:

card, err := client.Issuing.Cards.Get(ctx, cardID)
if err != nil {
    log.Printf("Error: %v\n", err)
    return
}

Example error format:

failed to get card: 404: card_not_found: Card not found (HTTP 404)

API coverage

Banking API

Resource	Operations
Balances	Get, List, ListTransactions
Transfers	Create, List, Get
Deposits	List, Get
Beneficiaries	Create, List, Get, Update, Delete, ListPaymentMethods, Check
Payouts	Create, List, Get
Virtual Accounts	Create, List
Conversions	CreateQuote, Create, List, Get, ListConversionDates
Exchange Rates	List

Issuing API

Resource	Operations
Cardholders	Create, Get, List
Cards	Create, Get, GetSecure, List, Recharge, Withdraw, UpdateStatus
Transactions	Get, List
Products	List

MCP

CLI

SDKs

GitHub

Installation

Quick start

Configuration

Authentication

Idempotency

Error handling

API coverage

Banking API

Issuing API

GitHub

​Installation

​Quick start

​Configuration

​Authentication

​Idempotency

​Error handling

​API coverage

​Banking API

​Issuing API

Installation

Quick start

Configuration

Authentication

Idempotency

Error handling

API coverage

Banking API

Issuing API