{"id":20051742,"url":"https://github.com/seerbit/seerbit-java-api-library","last_synced_at":"2025-05-05T11:31:53.762Z","repository":{"id":37902339,"uuid":"235063851","full_name":"seerbit/seerbit-java-api-library","owner":"seerbit","description":"Seerbit API Library for Java (Version 1 \u0026 2)","archived":false,"fork":false,"pushed_at":"2024-02-05T22:38:51.000Z","size":684,"stargazers_count":2,"open_issues_count":5,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-08T22:23:08.577Z","etag":null,"topics":["cardservice","java","java-library","payment-gateway","payment-integration","seerbit","seerbit-api"],"latest_commit_sha":null,"homepage":"http://doc.seerbit.com/","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":"2020-01-20T09:27:01.000Z","updated_at":"2022-06-14T16:15:34.000Z","dependencies_parsed_at":"2023-01-21T12:33:44.986Z","dependency_job_id":null,"html_url":"https://github.com/seerbit/seerbit-java-api-library","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-java-api-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-java-api-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-java-api-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seerbit%2Fseerbit-java-api-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seerbit","download_url":"https://codeload.github.com/seerbit/seerbit-java-api-library/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":["cardservice","java","java-library","payment-gateway","payment-integration","seerbit","seerbit-api"],"created_at":"2024-11-13T12:05:38.776Z","updated_at":"2025-05-05T11:31:53.268Z","avatar_url":"https://github.com/seerbit.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cdiv align=\"center\"\u003e\n \u003cimg width=\"400\" valign=\"top\" src=\"https://assets.seerbitapi.com/images/seerbit_logo_type.png\"\u003e\n\u003c/div\u003e\n\n\n\u003ch1 align=\"center\"\u003e\n  \u003cimg width=\"40\" valign=\"bottom\" src=\"https://res.cloudinary.com/dcksdncso/image/upload/v1579682633/java_f2iyuf.png\"\u003e\n  seerbit-java-v1\n\u003c/h1\u003e\n\n\u003ch4 align=\"center\"\u003e\n  A Seerbit API Library for Java (Version 1)\n\u003c/h4\u003e\n\n## Features\n\nThe Library supports all APIs under the following services:\n* Payment via API (card and account)\n* Disputes\n* Refunds\n* Transaction Status\n\n## Getting Started\n\nA full getting started guide for integrating SeerBit can be found at [getting started docs](https://doc.seerbit.com).\n\n## Documentation\n\nThe documentation, installation guide, detailed description of the SeerBit API and all of its features is [available on the documentation website](https://doc.seerbit.com/api/library)\n\n\n## Requirements\n\n* Java 8 or higher\n* Maven\n\n\n## Installation\n\n### Maven\n\nAdd this dependency to your project's POM:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.seerbit\u003c/groupId\u003e\n  \u003cartifactId\u003eseerbit-java-api\u003c/artifactId\u003e\n  \u003cversion\u003e1.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Contributing\n\nYou can contribute to this repository so that anyone can benefit from it:\n\n* Improved features\n* Resolved bug fixes and issues\n\n## Examples  \n\nYou can also check the [src/main/java/com/seerbit/demo](https://github.com/seerbit/seerbit-java-v1/tree/master/src/main/java/com/seerbit/demo) folder in this repository for more examples of usage.\n\n## Using the Library\n\n\u003cstrong\u003e\u003ch4\u003eInitiate Card Transaction\u003c/h4\u003e\u003c/strong\u003e\nInstantiate a client and set the parameters.\n\n```java\n    Seerbit seerbitApp = new SeerbitImpl();\n    Client client = new Client();\n    client.setAPIBase(seerbitApp.getApiBase());\n    client.setEnvironment(EnvironmentEnum.LIVE.getEnvironment());\n    client.setPublicKey(\"public_key\");\n    client.setPrivateKey(\"private_key\");\n    client.setTimeout(20);\n```\n\nTo initiate a transaction request you need to perform a transaction authentication. \n\n```java\n    TransactionAuthenticationImpl authService = new TransactionAuthenticationImpl(client);\n    JsonObject response = authService.doAuth();\n```\n\nThen retrieve your token after authenticating and pass it to the CardService constructor along with your client object. You can then construct your payload and call the \u003ccode\u003edoAuthorize()\u003c/code\u003e method of the CardService class.\n```java\n    String token = authService.getToken();\n  \n    CardService cardService = new CardServiceImpl(client, token);\n\n    CardDetail cardDetail = new CardDetail();\n    cardDetail.setCvv(\"100\");\n    cardDetail.setNumber(\"5123450000000008\");\n    cardDetail.setExpiryMonth(\"05\");\n    cardDetail.setExpiryYear(\"21\");\n    cardDetail.setPin(\"1234\");\n\n    Card card = new Card();\n    card.setFullname(\"Sambo Chukwuma Adetutu\");\n    card.setPublicKey(client.getConfig().getPublicKey());\n    card.setTransactionReference(\"trx00001\");\n    card.setEmail(\"sambo@example.com\");\n    card.setMobile(\"08012345678\");\n    card.setChannelType(\"account\");\n    card.setDeviceType(\"Nokia 3310\");\n    card.setSourceIP(\"127.0.0.20\");\n    card.setType(\"3DSECURE\");\n    card.setCurrency(\"NGN\");\n    card.setDescription(\"put a descriptive message here\");\n    card.setCountry(\"NG\");\n    card.setFee(\"1.00\");\n    card.setAmount(\"150.00\");\n    card.setClientAppCode(\"appl\");\n    card.setCallbackUrl(\"http://www.example.com\");\n    card.setRedirectUrl(\"http://www.example.com\");\n    card.setCardDetail(cardDetail);\n\n    JsonObject json = cardService.doAuthorize(card);\n``` \n\nFind more examples [here](https://github.com/seerbit/seerbit-java-v1/tree/master/src/main/java/com/seerbit/demo).\n\n## Licence\nGNU General Public License. For more information, see the LICENSE file.\n\n## Website\n* https://seerbit.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseerbit%2Fseerbit-java-api-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseerbit%2Fseerbit-java-api-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseerbit%2Fseerbit-java-api-library/lists"}