{"id":20051734,"url":"https://github.com/seerbit/seerbit-android","last_synced_at":"2025-07-22T10:33:32.982Z","repository":{"id":37896500,"uuid":"443826588","full_name":"seerbit/seerbit-android","owner":"seerbit","description":"SeerBit Android Checkout SDK","archived":false,"fork":false,"pushed_at":"2022-09-05T09:18:50.000Z","size":168,"stargazers_count":1,"open_issues_count":0,"forks_count":5,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-08T22:23:08.541Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/seerbit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-02T17:22:26.000Z","updated_at":"2022-02-25T18:16:40.000Z","dependencies_parsed_at":"2023-01-17T17:31:16.397Z","dependency_job_id":null,"html_url":"https://github.com/seerbit/seerbit-android","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seerbit","download_url":"https://codeload.github.com/seerbit/seerbit-android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252489076,"owners_count":21756260,"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":[],"created_at":"2024-11-13T12:05:37.981Z","updated_at":"2025-05-05T11:31:53.166Z","avatar_url":"https://github.com/seerbit.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg width=\"400\" valign=\"top\" src=\"https://assets.seerbitapi.com/images/seerbit_logo_type.png\" data-canonical-src=\"https://res.cloudinary.com/dpejkbof5/image/upload/v1620323718/Seerbit_logo_png_ddcor4.png\" style=\"max-width:100%; \"\u003e\n\u003c/p\u003e\n\n# Seerbit Android SDK\n\nSeerit Android SDK can be used to integrate the SeerBit payment gateway into your Android application.\n\n## Requirements\nRegister for a merchant account on [Seerbit Merchant Dashboard](https://dashboard.seerbitapi.com) to get started.\nTo get a Git project into your build:\n\n\n\nStep 1. Add the JitPack repository to your build file\n\n### Gradle\nAdd it in your root build.gradle at the end of repositories:\n\n\tallprojects {\n\t\trepositories {\n\t\t\t...\n\t\t\tmaven { url 'https://jitpack.io' }\n\t\t}\n\t}\nStep 2. Add the dependency\n\n\tdependencies {\n\t        implementation 'com.github.seerbit:seerbit-android:1.1.7'\n\t}\n\n\n### Maven\nStep 1. Add the JitPack repository to your build file\n\n\t\u003crepositories\u003e\n\t\t\u003crepository\u003e\n\t\t    \u003cid\u003ejitpack.io\u003c/id\u003e\n\t\t    \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n\t\t\u003c/repository\u003e\n\t\u003c/repositories\u003e\n\nStep 2. Add the dependency\n\n\t\u003cdependency\u003e\n\t    \u003cgroupId\u003ecom.github.seerbit\u003c/groupId\u003e\n\t    \u003cartifactId\u003eseerbit-android\u003c/artifactId\u003e\n\t    \u003cversion\u003e1.1.7\u003c/version\u003e\n\t\u003c/dependency\u003e\n## API Documentation\nhttps://doc.seerbit.com\n\n## Support\nIf you have any problems, questions or suggestions, create an issue here or send your inquiry to developers@seerbit.com\n\n## Implementation\nYou should already have your API keys. If not, go to [dashboard.seerbitapi.com](https://dashboard.seerbitapi.com).\n\n## Quick Start\n\n```xml\n\u003cFrameLayout\n    android:id=\"@+id/view\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"match_parent\"\n    app:layout_constraintBottom_toBottomOf=\"parent\"\n    app:layout_constraintLeft_toLeftOf=\"parent\"\n    app:layout_constraintRight_toRightOf=\"parent\"\n    app:layout_constraintTop_toTopOf=\"parent\"/\u003e\n```\n\nNext create an instance of a seerbit view and add it into a framelayout\n```java\n\nFrameLayout webView = findViewById(R.id.view);\n\n//Create a new transaction model\nTransactionModel transactionModel = new TransactionModel();\nString transRef = \"\"+System.currentTimeMillis();\ntransactionModel.setTranref(transRef);\ntransactionModel.setCurrency(\"your currency\");\ntransactionModel.setEmail(\"your email address\");\ntransactionModel.setAmount(your amount in integer);\ntransactionModel.setDescription(\"your description\");\ntransactionModel.setCountry(\"your country\");\ntransactionModel.setCallbackurl(\"https://yourcallbackurl.com\");\ntransactionModel.setPublic_key(\"your public key\");\ntransactionModel.setFull_name(\"full name\");\ntransactionModel.setClose_on_success(false);\ntransactionModel.setTokenize(false);\n\n//Create a new instance of seerbitview\nSeerbitView seerbitWebView = new SeerbitView(this);\nwebView.addView(seerbitWebView);\n\n// opens the view with the defined transaction model\nseerbitWebView.open(transactionModel);\n\t\n//add a EventListener to listen to various states of the sdk\nseerbitWebView.addEventListener(new SeerbitView.EventsListener() {\n     @Override\n     public void OnCompleteListener(SuccessModel successModel) {\n     \t//get data associated with transaction\n     \tLog.d(TAG, \"OnCompleteListener: \"+successModel.getResponse().getPayments().getCountry());\n\t//Close the webivew\n        seerbitWebView.close();\n     }\n\n     @Override\n     public void onCloseListener() {\n         //Case whem the user cancels the transaction manually\n         seerbitWebView.close();\n     }\n\n     @Override\n     public void onError() {\n          //Something went wrong close transaction\n           seerbitWebView.close();\n       }\n\n    });\n```\n\n## API Documentation\nThe following sections provides detailed documentation for every component in the library.\n\n\n### TransactionModel\nA transaction model is used for passing data to seerbit SDK, it contains details such as the transaction reference, the currency of the transaction, the email, the amount, the description, country, callback url (which is a url used for callbacks), your public key, and the full name. In order for seerbit SDK to open a valid transaction model all these values must be set before calling the .open() method. If not the seerbit SDK might not be initialized properly. This is an example of a valid transaction model\n```java\nTransactionModel transactionModel = new TransactionModel();\n/*\ntransRef-\u003e String: Used as a transaction reference\n*/\nString transRef = \"\"+System.currentTimeMillis();\ntransactionModel.setTranref(transRef);\n/**\n Currency-\u003e String: Used to specify the currency of payment\n */\ntransactionModel.setCurrency(\"NGN\");\n/**\n Email-\u003e String: Used to specify the email attached to the transaction\n*/\ntransactionModel.setEmail(\"seerbittest@gmail.com\");\n/**\n Amount-\u003e int: Used to specify the amount of payment to be made\n*/\ntransactionModel.setAmount(100);\n/**\n Description-\u003e String: Used to specify the description of the payment\n */\ntransactionModel.setDescription(\"Payment of bils\");\n/**\n Country-\u003e String: Used to specify the Country\n*/\ntransactionModel.setCountry(\"NG\");\n/**\nCallbackurl-\u003e String: Used to specify the callback \nurl this can be passed as an empty string if none is avaliable\n*/\ntransactionModel.setCallbackurl(\"https://whatever.com\");\n/**\n Public key-\u003e String: Used to specify the public key associated with the developers account\n*/\ntransactionModel.setPublic_key(\"public key\");\n/**\n *Fullname-\u003e String: Used to specify the full name associated with the payment\n*/\ntransactionModel.setFull_name(\"Seer Bit\");\n\n/**\n*Close on Success -\u003e Boolean: Used to tell thw SDK whether to close immediately after a successful transaction or not (defaults to true)\n*/\ntransactionModel.setClose_on_success(false);\n\n/**\n*Tokenize -\u003e Boolean: Used to tokenize cards for subscription (defaults to false)\n*/\ntransactionModel.setTokenize(false);\n\n\n```\n### Closing the seerbit SDK\n\nIn case the need ever arises to manually close the seerbit SDK. There is a method that can be used to release all resources associated with the view. This is done by using the .close() which takes in no arguments.\n\n### State flow of the API\n\nThe expected workflow of the API is to firstly create an instance of the seerbit SDK, the call the .open() method by passing it a transaction model to open, the view is automatically closed after a successful transaction. click [here](https://github.com/seerbit/seerbit-android/tree/master/app) for an example app\n\n\n## Contributors\n\u003cspan\u003e\n\u003ca href=\"https://github.com/adewoleopeyemi\" title=\"Adewole Opeyemi\"\u003e\n  \u003cimg src=\"https://github.com/adewoleopeyemi.png?size=50\"\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://github.com/amoskeyz\" title=\"amoskeyz\"\u003e\n  \u003cimg src=\"https://github.com/amoskeyz.png?size=50\"\u003e\n\u003c/a\u003e\n\u003c/a\u003e\n   \u003ca href=\"https://github.com/victorighalo\" title=\"Victor Ighalo\"\u003e\n  \u003cimg src=\"https://github.com/victorighalo.png?size=50\"\u003e\n\u003c/a\u003e\n   \u003c/span\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseerbit%2Fseerbit-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseerbit%2Fseerbit-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseerbit%2Fseerbit-android/lists"}