monobank

README

go-monobank

Monobank REST API client. Currently, supported only personal authorization(with Token).

Usage

package main

import (
    "context"
    "fmt"
    "os"

    "github.com/vtopc/go-monobank"
)

func main(){
    client := monobank.New(nil).WithAuth(monobank.NewPersonalAuthorizer(os.Getenv("TOKEN")))
    response, _ := client.ClientInfo(context.Background())
    fmt.Println(response)
}

Official docs

• https://api.monobank.ua/docs/

Similar projects

• https://github.com/shal/mono
• https://github.com/artemrys/go-monobank-api

TODO

• Corporate Authorization
• Corporate API(init/check auth)
• More unit tests

Documentation

Overview

Package mono - is MonoBank API client https://api.monobank.ua/docs/

Index

• type Account
• type Accounts
• type Authorizer
• type CardType
• type Client
  • func New(client *http.Client) Client
  • func (c Client) Auth(ctx context.Context, callbackURL string) (*TokenRequest, error)
  • func (c Client) CheckAuth(ctx context.Context) error
  • func (c Client) ClientInfo(ctx context.Context) (*ClientInfo, error)
  • func (c Client) Currency(ctx context.Context) (Currencies, error)
  • func (c Client) SetWebHook(ctx context.Context, uri string) error
  • func (c Client) Transactions(ctx context.Context, accountID string, from, to time.Time) (Transactions, error)
  • func (c Client) WithAuth(auth Authorizer) Client
  • func (c Client) WithBaseURL(uri string) Client
• type ClientInfo
• type CorporateAPI
• type Currencies
• type Currency
• type PersonalAPI
• type PersonalAuthorizer
  • func NewPersonalAuthorizer(token string) PersonalAuthorizer
  • func (a PersonalAuthorizer) SetAuth(req *http.Request) error
• type PublicAPI
• type PublicAuthorizer
  • func NewPublicAuthorizer() PublicAuthorizer
  • func (a PublicAuthorizer) SetAuth(_ *http.Request) error
• type TokenRequest
• type Transaction
• type Transactions
• type WebHookData
• type WebHookRequest
• type WebHookResponse

Types

type Account

type Account struct {
	AccountID    string   `json:"id"`
	Balance      int64    `json:"balance"`
	CreditLimit  int64    `json:"creditLimit"`
	CurrencyCode int      `json:"currencyCode"`
	CashbackType string   `json:"cashbackType"` // enum: None, UAH, Miles
	CardMasks    []string `json:"maskedPan"`    // card number masks
	Type         CardType `json:"type"`
}

type Accounts

type Accounts []Account

type Authorizer

type Authorizer interface {
	// SetAuth modifies http.Request and sets authorization tokens
	SetAuth(*http.Request) error
}

type CardType

type CardType string

const (
	Black    CardType = "black"
	White    CardType = "white"
	Platinum CardType = "platinum"
)

type Client

type Client struct {
	// contains filtered or unexported fields
}

func New

func New(client *http.Client) Client

New - returns new monobank Client

func (Client) Auth

func (c Client) Auth(ctx context.Context, callbackURL string) (*TokenRequest, error)

Auth initializes access.

func (Client) CheckAuth

func (c Client) CheckAuth(ctx context.Context) error

CheckAuth checks status of request for client's personal data.

func (Client) ClientInfo

func (c Client) ClientInfo(ctx context.Context) (*ClientInfo, error)

func (Client) Currency

func (c Client) Currency(ctx context.Context) (Currencies, error)

func (Client) SetWebHook

func (c Client) SetWebHook(ctx context.Context, uri string) error

func (Client) Transactions

func (c Client) Transactions(ctx context.Context, accountID string, from, to time.Time) (
	Transactions, error)

TODO: make `to` optional

func (Client) WithAuth

func (c Client) WithAuth(auth Authorizer) Client

WithAuth returns copy of Client with authorizer

func (Client) WithBaseURL

func (c Client) WithBaseURL(uri string) Client

WithAuth returns copy of Client with overridden baseURL

type ClientInfo

type ClientInfo struct {
	Name       string   `json:"name"`
	WebHookURL string   `json:"webHookUrl"`
	Accounts   Accounts `json:"accounts"`
}

ClientInfo - client/user info

type CorporateAPI

type CorporateAPI interface {
	PersonalAPI
}

type Currencies

type Currencies []Currency

type Currency

type Currency struct {
	CurrencyCodeA int           `json:"currencyCodeA"`
	CurrencyCodeB int           `json:"currencyCodeB"`
	Date          epoch.Seconds `json:"date"`
	RateSell      float64       `json:"rateSell"`
	RateBuy       float64       `json:"rateBuy"`
	RateCross     float64       `json:"rateCross"`
}

type PersonalAPI

type PersonalAPI interface {
	PublicAPI

	// ClientInfo - https://api.monobank.ua/docs/#/definitions/UserInfo
	ClientInfo(context.Context) (*ClientInfo, error)

	// Transactions - gets bank account statements(transations)
	// https://api.monobank.ua/docs/#/definitions/StatementItems
	Transactions(ctx context.Context, accountID string, from, to time.Time) (Transactions, error)

	// SetWebHook - sets webhook for statements
	SetWebHook(ctx context.Context, uri string) error
}

type PersonalAuthorizer

type PersonalAuthorizer struct {
	// contains filtered or unexported fields
}

func NewPersonalAuthorizer

func NewPersonalAuthorizer(token string) PersonalAuthorizer

func (PersonalAuthorizer) SetAuth

func (a PersonalAuthorizer) SetAuth(req *http.Request) error

type PublicAPI

type PublicAPI interface {
	// Currency https://api.monobank.ua/docs/#/definitions/CurrencyInfo
	Currency(context.Context) (Currencies, error)
}

type PublicAuthorizer

type PublicAuthorizer struct{}

func NewPublicAuthorizer

func NewPublicAuthorizer() PublicAuthorizer

func (PublicAuthorizer) SetAuth

func (a PublicAuthorizer) SetAuth(_ *http.Request) error

type TokenRequest

type TokenRequest struct {
	RequestID string `json:"tokenRequestId"` // Unique token request ID.
	AcceptURL string `json:"acceptUrl"`      // URL to redirect client or build QR on top of it.
}

type Transaction

type Transaction struct {
	ID              string        `json:"id"`
	Time            epoch.Seconds `json:"time"`
	Description     string        `json:"description"`
	MCC             int32         `json:"mcc"`
	Hold            bool          `json:"hold"`
	Amount          int64         `json:"amount"`
	OperationAmount int64         `json:"operationAmount"`
	CurrencyCode    int           `json:"currencyCode"`
	CommissionRate  int64         `json:"commissionRate"`
	CashbackAmount  int64         `json:"cashbackAmount"`
	Balance         int64         `json:"balance"`
	Comment         string        `json:"comment"`
}

Transaction - bank account statement

type Transactions

type Transactions []Transaction

Transactions - transactions

type WebHookData

type WebHookData struct {
	AccountID   string      `json:"account"`
	Transaction Transaction `json:"statementItem"`
}

type WebHookRequest

type WebHookRequest struct {
	WebHookURL string `json:"webHookUrl"`
}

type WebHookResponse

type WebHookResponse struct {
	Type string      `json:"type"` // "StatementItem"
	Data WebHookData `json:"data"`
}