{"id":18409901,"url":"https://github.com/toorop/go-qonto","last_synced_at":"2025-10-28T04:02:38.186Z","repository":{"id":57592974,"uuid":"117854603","full_name":"toorop/go-qonto","owner":"toorop","description":"Go API client and CLI for https://qonto.eu/ banking service.","archived":false,"fork":false,"pushed_at":"2018-01-18T14:23:13.000Z","size":2550,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-20T14:25:14.464Z","etag":null,"topics":["cli","golang","golang-package","qonto","rest-client"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toorop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-01-17T15:27:22.000Z","updated_at":"2021-04-30T20:38:30.000Z","dependencies_parsed_at":"2022-09-26T19:43:32.898Z","dependency_job_id":null,"html_url":"https://github.com/toorop/go-qonto","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toorop%2Fgo-qonto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toorop%2Fgo-qonto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toorop%2Fgo-qonto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toorop%2Fgo-qonto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toorop","download_url":"https://codeload.github.com/toorop/go-qonto/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223276869,"owners_count":17118427,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","golang","golang-package","qonto","rest-client"],"created_at":"2024-11-06T03:27:52.450Z","updated_at":"2025-10-06T17:49:48.900Z","avatar_url":"https://github.com/toorop.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"Go API client and CLI for [Qonto](https://qonto.eu/) banking service.\n\n[![Build Status](https://api.travis-ci.org/toorop/go-qonto.svg?branch=master)](https://travis-ci.org/toorop/go-qonto)\u0026nbsp;[![GoDoc](https://godoc.org/github.com/toorop/go-qonto?status.svg)](https://godoc.org/github.com/toorop/go-qonto)\t\n## DISCLAIMER\nThis package and the CLI are not provided nor supported by Qonto\n\n## go-qonto package quickstart\n\n```go get github.com/toorop/go-qonto```\n\n```go\nimport \"github.com/toorop/go-qonto\"\n\nfunc main(){\n    Q := qonto.New(\"qonto-login\", \"qonto-API-secret\")\n    organization, err := Q.GetOrganization(\"slug\")\n\tif err != nil {\n\t\tfmt.Println(\"ERROR ! unable to get organization -\", err)\n\t\tos.Exit(1)\n\t}\n\tfmt.Println(organization)\n}\n```\n\nTo get last transactions:\n\n```go\nimport \"github.com/toorop/go-qonto\"\n\nfunc main(){\n    Q := qonto.New(\"qonto-login\", \"qonto-API-secret\")\n\toptions := qonto.GetTransactionOptions{\n\t\tSlug:   \"slug\",\n\t\tIban:   \"iban\",\n\t\tStatus: []string{\"pending\", \"reversed\", \"declined\", \"completed\"},\n    }\n    transactions, err := Q.GetTransactions(options)\n\tif err != nil {\n\t\tfmt.Println(\"ERR: \", err)\n\t\tos.Exit(1)\n    }\n    for _, transaction := range transactions {\n        fmt.Println(transaction)\n    }\n}\n```\n\n## qonto CLI\nqonto CLI allow you interact with Qonto services from the command line\n\n### Installation\n\n#### By downloading pre-build binary for your system\nqonto CLI is available as compiled binary for Windows, Mac OS, and Linux (386, amd64, arm, arm64 flavors) \n\n\u003ca href=\"https://github.com/toorop/go-qonto/releases/\" target=\"_blank\"\u003eDownload from qonto CLI releases page\u003c/a\u003e\n\nOnce you have downloaded the last release, it could be a goood idea to rename the binary ;)\n\n```\nmv qonto_0.0.1-alpha_Linux-64bit qonto\n```\n\n#### By compiling you own binary from source\n\n- \u003ca href=\"https://golang.org/\" target=\"_blank\"\u003eInstall Go (at least 1.9) on your system\u003c/a\u003e\n- \"go get\" dépendencies:\n    ```\n    $ go get -u github.com/asaskevich/govalidator\n\t$ go get -u github.com/spf13/cobra\n\t$ go get -u github.com/spf13/viper\n    ```\n- \"go get\" source code:\n    ```bash\n    $ go get github.com/toorop/go-qonto\n    ```\n\n- run \"go install\" to build and install qonto CLI\n    ```\n    $ cd $GOPATH/src/github.com/toorop/go-qonto/qonto\n    $ go install\n    ```\n- qonto binary should be available on yout $PATH:\n    ```\n    $ qonto --version\n    qonto version 0.0.1-alpha\n    ```\n\n\n\n\n### Configuration\nYou need to setup some configuration before running qonto CLI, at least you must provide your Qonto ID and your Qonto secret API key (see \"integration\" on your Qonto dashboard).\n\nYou have two ways to proceed:\n\n* Using a config file (needed if you want to use the 'watch' command with email notifiaction).\n    - Download config.sample.yaml from: [https://raw.githubusercontent.com/toorop/go-qonto/master/qonto/config.sample.yaml](https://raw.githubusercontent.com/toorop/go-qonto/master/qonto/config.sample.yaml)\n    - Save it as config.yaml in the same path as your qonto binary (you can save it elsewhere but in this case you need ton provide its full path with the --config option).\n    - Fill the required fields.\n    - That's it. \n\nWARNING: if you put qonto binary on your binaries PATH, you need to use the --config option or to put your config file on your working dir.\n\n- Using environment variables (for basic usages)\n    - export QONTO_LOGIN \u0026 QONTO_SECRET\n\nIf you need new commands or features please open an issue.\n\n### help\nqonto CLI have a builtin help, to access it you just have to use the *--help* flag.\n\nExample:\n\n```\n$ qonto organization --help\n\nDisplay your Qonto organizations\n\nExample:\n\n$ qonto organization\nmy-orga-42\n                Slug: my-orga-42-bank-account-1\n                IBAN: FR76XXXXXXXXX\n                BIC: XXXXXXXX\n                Currency: EUR\n                Balance (€): 100000000.000000\n                Balance (cents): 10000000000\n                Authorized Balance (€): 0.000000\n                Auhorized Balance (cents): 0\n\nUsage:\n  qonto organization [flags]\n\nFlags:\n  -h, --help   help for organization\n\nGlobal Flags:\n  -c, --config string   config file\n```\n\n\n### watch command\n\n*watch* command allow you to be informed on new transations or on transaction updates.\n\nBy default *watch command* display update on stdout, but it can send a email and/or send a POST request, containing the transaction update, to a predefined URL.\n\nTo keep the *watch* command running when you logout, add \"\u0026\" at the and of the command ou use [tmux](https://github.com/tmux/tmux/wiki)\n\n#### email notifications\n\nAn email will be send to the defined address on each transaction event.\nTo receive email notifications you must configure *smtp* section of the config file to provide at least *smtp.host*, *smtp.port* and *smtp.mailfrom*.\n\nExample:\n\nTo receive an email notification on each event\n\n```\nqonto watch --slug SLUG --iban IBAN -m EMAIL_ADDRESS_TO_SEND_MAIL_TO\n```\n\n\n#### webhook\n\nTo enable webhook notification you just have to add the *--webhook* flag with a valid URL\n\n```\nqonto watch --slug SLUG --ib IBAN --webhook https://qonto.toorop.fr -m EMAIL_ADDRESS_TO_SEND_MAIL_TO\n```\n\nqonto CLI will do a POST request to this URL, with the JSON encoded transaction object in the request body, on each transaction update.\n\nThe format of the JSON object is same as the one returned by [Qonto API](https://api-doc.qonto.eu/2.0/models/transaction)\n\n\n### organization command\n\n*organization* command returns details about your organization and your banks accounts.\n\nExample:\n```\n$ qonto organization\nmy-orga-42\n                Slug: my-orga-42-bank-account-1\n                IBAN: FR76XXXXXXXXX\n                BIC: XXXXXXXX\n                Currency: EUR\n                Balance (€): 100000000.000000\n                Balance (cents): 10000000000\n                Authorized Balance (€): 0.000000\n                Auhorized Balance (cents): 0\n\n```\n\n## Support this project\nIf this project is useful for you, please consider making a donation.\n\n### Bitcoin\n\nAddress: 1JvMRNRxiTiN9H7LyZTq4yzR7ez86M7ND6\n\n![Bitcoin QR code](https://raw.githubusercontent.com/toorop/wallets/master/btc.png)\n\n\n### Ethereum\n\nAddress: 0xA84684B45969efbD54fd25A1e2eD8C7790A0C497\n\n![ETH QR code](https://raw.githubusercontent.com/toorop/wallets/master/eth.png)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoorop%2Fgo-qonto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoorop%2Fgo-qonto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoorop%2Fgo-qonto/lists"}