Adyen API Library for Java
+ + + + + ++ The Checkout API service has the following methods: +
+Queries the available payment methods for a transaction based on the transaction context (like amount, + country, and currency). Besides giving back a list of the available payment methods, the response also + returns which input details you need to collect from the shopper (to be submitted to payments( + )).
+Although we highly recommend using this endpoint to ensure you are always offering the most up-to-date list + of payment methods, its usage is optional. You can, for example, also cache the paymentMethods( + ) response and update it once a week.
+Checkout checkout = new Checkout(client);
+PaymentMethodsRequest paymentMethodsRequest = new PaymentMethodsRequest();
+paymentMethodsRequest.setMerchantAccount("YourMerchantAccount");
+PaymentMethodsResponse response = checkout.paymentMethods(paymentMethodsRequest);
+Sends payment parameters (like amount, country, and currency) together with the input details collected from + the shopper. The response returns the result of the payment request:
+Checkout checkout = new Checkout(client);
+PaymentsRequest paymentsRequest = new PaymentsRequest();
+Amount amount = new Amount();
+amount.setCurrency("USD");
+amount.setValue(1000L);
+paymentsRequest.setReference("Your order number");
+paymentsRequest.setAmount(amount);
+paymentsRequest.setPaymentMethod(new HashMap<String, String>());
+paymentsRequest.putPaymentMethodItem("number", "4111111111111111");
+paymentsRequest.putPaymentMethodItem("type", "scheme");
+paymentsRequest.putPaymentMethodItem("expiryMonth", "08");
+paymentsRequest.putPaymentMethodItem("expiryYear", "2018");
+paymentsRequest.putPaymentMethodItem("holderName", "John Smith");
+paymentsRequest.putPaymentMethodItem("cvc", "737");
+paymentsRequest.setReturnUrl("https://your-company.com/...");
+paymentsRequest.setMerchantAccount("YOUR_MERCHANT_ACCOUNT");
+PaymentsResponse paymentResponse = checkout.payments(paymentsRequest);
+Submits details for a payment created using payments( ). This step is only needed when no + final state has been reached on the payments( ) request (for example for 3D Secure, or when + getting redirected back directly from a payment method using an app switch).
+The exact details, which need to be sent to this endpoint, are always specified in the response of the + associated payments( ) request. When sending in the request to paymentsDetails( + ), make sure you send the corresponding paymentData as obtained during the payments( + ) call.
+In addition, the endpoint can be used to verify a payload, which is returned after coming + back from the Checkout SDK or any of the redirect based methods on the Checkout API.
+Checkout checkout = new Checkout(client);
+PaymentsDetailsRequest paymentsDetailsRequest = new PaymentsDetailsRequest();
+paymentsDetailsRequest.setPaymentData("Hee57361f99....");
+HashMap<String, String> details = new HashMap<>();
+details.put("MD", "sdfsdfsdf...");
+details.put("PaRes", "sdfsdfsdf...");
+paymentsDetailsRequest.setDetails(details);
+PaymentsResponse paymentsResponse = checkout.paymentsDetails(paymentsDetailsRequest);
+Adyen API Library for Java
+ + + + + ++ The Checkout SDK service has the following methods: +
+Provides the data object that can be used to start the Checkout SDK. To set up the payment, pass its amount, currency, and other required parameters. We use this to optimise the payment flow and perform better risk assessment of the transaction.
+Checkout checkout = new Checkout(client);
+PaymentSessionRequest paymentSessionRequest = new PaymentSessionRequest();
+paymentSessionRequest.setAmount(createAmountObject("EUR", 17408L));
+paymentSessionRequest.setReference("Your order number");
+paymentSessionRequest.returnUrl("https://www.yourshop.com/checkout/result");
+paymentSessionRequest.merchantAccount("YOUR_MERCHANT_ACCOUNT");
+paymentSessionRequest.setCountryCode("NL");
+paymentSessionRequest.setSdkVersion("1.3.0");
+PaymentSessionResponse paymentSessionResponse = checkout.paymentSession(paymentSessionRequest);
+Verifies the payment result using the payload returned from the Checkout SDK.
+Checkout checkout = new Checkout(client);
+PaymentResultRequest paymentResultRequest = new PaymentResultRequest();
+paymentResultRequest.setPayload("This is a test payload");
+PaymentResultResponse paymentResultResponse = checkout.paymentResult(paymentResultRequest);
+Adyen API Library for Java
+ + + + + ++ The Checkout Utility service has the following method: +
++ This operation takes the origin domains and returns a JSON object containing the corresponding origin keys + for the domains. +
+CheckoutUtility checkoutUtility = new CheckoutUtility(client);
+OriginKeysRequest originKeysRequest = new OriginKeysRequest();
+originKeysRequest.setOriginDomains(new ArrayList<String>(Arrays.asList("https://www.your-domain1.com", "https://www.your-domain2.com")));
+OriginKeysResponse originKeysResponse = checkoutUtility.originKeys(originKeysRequest);
+Adyen API Library for Java
+ + + + + ++ This manual describes API communication to the Adyen payment system using this API library for Java. + You will get familiar with the following concepts and scenarios: +
+ +The ownership of the content of the Adyen API Library remains with Adyen. The content of the Adyen API + Library may only be used in connection with the services of Adyen and subject to the applicable license + (Apache License, Version 2.0, the “License”), a copy of which is included in the library. Unless required by + applicable law or agreed to in writing, the library is offered and/or distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Adyen does not warrant that the + library or any content will be available uninterrupted or error free, that defects will be corrected, or + that the library or its supporting systems are free of viruses or bugs. Please refer to the License for the + specific language governing permissions and limitations under the License.
+Adyen API Library for Java
+ + + + + ++
You can use Maven or simply download the release.
+Add this dependency to your project’s POM:
+<dependency>
+ <groupId>com.adyen</groupId>
+ <artifactId>adyen-java-api-library</artifactId>
+ <version>1.5.0</version>
+</dependency>
+Adyen API Library for Java
+ + + + + +
+ Set up a client and set the credentials to the Adyen platform.
+ If you don't know your X-API-KEY, you can obtain it from the Customer Area, as described in How to get the
+ Checkout API key
+
Config config = new Config();
+config.setApiKey("Your X-API-KEY"));
+config.setApplicationName("Adyen Java API Library");
+Client client = new Client(config);
+client.setEnvironment(Environment.TEST);
++ If you are not using Checkout, you can use the authentication with + Webservice Username and Password instead of the X-API-KEY: +
+config.setUsername("YOUR USERNAME");
+config.setPassword("YOUR PASSWORD");
++ The example connects you to the Adyen test platform. If you want to use our live platform use: +
+client.setEnvironment(Environment.LIVE);
+Adyen Checkout API provides a simple and flexible way to initiate and authorise online payments. + You can use the same integration for payments made with cards (including One-Click and 3D Secure), mobile + wallets, and local payment methods (e.g. iDEAL and Sofort). + To learn more about the API, visit Checkout + documentation. +
+ + +A web service containing utility functions available for merchants integrating with Checkout APIs.
+