{"id":15044117,"url":"https://github.com/worldline/sips-sdk-java","last_synced_at":"2025-04-10T00:42:25.329Z","repository":{"id":33923553,"uuid":"120437142","full_name":"worldline/sips-sdk-java","owner":"worldline","description":null,"archived":false,"fork":false,"pushed_at":"2023-10-19T13:27:09.000Z","size":161,"stargazers_count":4,"open_issues_count":2,"forks_count":9,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-04-10T00:41:51.583Z","etag":null,"topics":["java-8","payment-gateway","payment-processing","sips","worldline"],"latest_commit_sha":null,"homepage":"https://sips.worldline.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/worldline.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-06T10:14:31.000Z","updated_at":"2023-08-28T09:41:18.000Z","dependencies_parsed_at":"2025-02-16T05:32:25.770Z","dependency_job_id":"bfc0aa6e-fc4c-4f6d-b281-70d1ca43cb44","html_url":"https://github.com/worldline/sips-sdk-java","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/worldline%2Fsips-sdk-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/worldline%2Fsips-sdk-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/worldline%2Fsips-sdk-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/worldline%2Fsips-sdk-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/worldline","download_url":"https://codeload.github.com/worldline/sips-sdk-java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248137999,"owners_count":21053775,"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":["java-8","payment-gateway","payment-processing","sips","worldline"],"created_at":"2024-09-24T20:50:05.968Z","updated_at":"2025-04-10T00:42:25.312Z","avatar_url":"https://github.com/worldline.png","language":"Java","readme":"# SIPS Payment SDK [![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.worldline.sips/payment-sdk/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.worldline.sips/payment-sdk)\nThis package provides a JAVA implementation for SIPS, a Worldline e-payments gateway.\n\n\u003e :warning: This library was written for SIPS 2.0 and is not compatible with SIPS 1.0\n\n## Before you begin\nThis package contains a basic connector for SIPS, based on the **SIPS Paypage JSON API**.\nPlease refer to the [documentation](https://documentation.sips.worldline.com) for a better understanding.\n\nIf you find field or functionality is missing, feel free to submit a PR or create an issue.  \n\n## Installing\n\n### using Gradle\n```groovy\n\ndependencies {\n    implementation 'com.worldline.sips:payment-sdk:1.4.3'\n}\n\n```\n\n### using Maven\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.worldline.sips\u003c/groupId\u003e\n    \u003cartifactId\u003epayment-sdk\u003c/artifactId\u003e\n    \u003cversion\u003e1.4.3\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Usage\n\u003e :bulb: Currently this library only supports SIPS in pay page mode.\n\n### Initialization\nFirst, create a client for the desired environment using your merchant ID, key version \u0026 secret key:\n```java\nPaypageClient paypageClient = new PaypageClient(\n        Environment.TEST, \n        \"002001000000002\", \n        1, // This shouldn't be hardcoded here...\n        \"002001000000002_KEY1\"); // ...and neither should this.\n```\n\u003e :bulb: Merchant data for SIPS TEST can be found in the documentation.\n\nThen set up a request to initialize a session on the SIPS server:\n\n```java\nPaymentRequest paymentRequest = new PaymentRequest();\npaymentRequest.setAmount(2);\npaymentRequest.setCurrencyCode(Currency.EUR);\npaymentRequest.setOrderChannel(OrderChannel.INTERNET);\n```\nAdd unique reference for the transaction:\n\n```java\npaymentRequest.setTransactionReference(\"My awesome transaction reference\");\n```\n\nAnd initialize your session on the server:\n```java\nInitalizationResponse initializationResponse = paypageClient.initialize(paymentRequest);\n```\n\nThe `initializationResponse` you'll receive from the server contains all information needed to continue \nhandling your transaction. If your initialization was successful, your response will contain a \n`RedirectionStatusCode.TRANSACTION_INITIALIZED`.\n\n### Making the payment\nIn case your initialization was successful, you have to use the `redirectionUrl` received to perform a POST request\nwith both the `redirectionData` and `seal` as parameters. Since this should redirect the customer the SIPS \npayment page, the cleanest example is a simple HTML form:\n\n```html\n\u003cform method=\"post\" action=\"redirectionUrl\"\u003e\n    \u003cinput name=\"redirectionData\" type=\"hidden\" value=\"...\" /\u003e\n    \u003cinput name=\"seal\" type=\"hidden\" value=\"...\" /\u003e\n    \u003cinput type=\"submit\" value=\"Proceed to checkout\"/\u003e\n\u003c/form\u003e\n```\n\n### Verifying the payment\nWhen your customer is done, he will be able to return to your application. This is done \nvia a form, making a POST request to the `normalReturnUrl` provided during the initialization of your payment.\nThis POST request contains details on the payment. You can simply decode these responses, providing a `Map\u003cString, String\u003e`\nof the parameters included in the received request to your `PaypageClient`:\n\n```java\nPaypageResponse paypageResponse = paypageClient.decodeResponse(mappedRequestParameters);\n```\n \n\u003e :warning: Since the customer is not always redirecting back (e.g. he closes the confirmation page), it's\na good practice to include an `automaticResponseUrl`. SIPS will always POST details on the transaction on this URL,\neven if a customer doesn't redirect back to your application.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworldline%2Fsips-sdk-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fworldline%2Fsips-sdk-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fworldline%2Fsips-sdk-java/lists"}