// Import the required classes
import com.adyen.Client;
import com.adyen.enums.Environment;
import com.adyen.service.checkout.PaymentsApi;
import com.adyen.model.checkout.*;

// Setup Client using Config object
Config config = new Config()
    .environment(Environment.LIVE)
    .liveEndpointUrlPrefix("myCompany")
    .apiKey(apiKey);
Client client = new Client(config);

PaymentsApi paymentsApi = new PaymentsApi(client);

// Create PaymentRequest 
CardDetails cardDetails =
    new CardDetails()
      .type(CardDetails.TypeEnum.SCHEME)
      .encryptedCardNumber("5136333333333335")
      .holderName("John Doe")
      .cvc("737")
      .encryptedExpiryMonth("08")
      .encryptedExpiryYear("2018");
PaymentRequest paymentRequest =
  new PaymentRequest()
      .merchantAccount("YOUR_MERCHANT_ACCOUNT")
      .reference("YOUR_REFERENCE")
      .amount(new Amount()
          .currency("EUR")
          .value(1000L))
      .returnUrl("https://your-company.example.org/checkout?shopperOrder=12xy..")
      .paymentMethod(new CheckoutPaymentMethod(cardDetails));

// Make a call to the /payments endpoint
PaymentResponse paymentResponse = paymentsApi.payments(paymentRequest);

// Import the required classes
import com.adyen.Client;
import com.adyen.enums.Environment;
import com.adyen.service.checkout.PaymentLinksApi

// Setup Client and Service passing prefix  
Client client = new Client("Your username", "Your password", Environment.LIVE, "mycompany123");
// Or setup Client and Service passing prefix and application name 
//Client client = new Client("Your username", "Your password", Environment.LIVE, "mycompany123", "Your application name");

PaymentLinksApi paymentLinksApi = new PaymentLinksApi(client);
 
...

import com.adyen.Client;
import com.adyen.Config;
import com.adyen.enums.Environment;
import com.adyen.model.RequestOptions;
import com.adyen.service.checkout.PaymentsApi;
import com.adyen.model.checkout.PaymentRequest;
import com.adyen.model.checkout.PaymentResponse;
import com.adyen.model.checkout.Amount;
import com.adyen.model.checkout.CardDetails;
import com.adyen.model.checkout.CheckoutPaymentMethod;

import java.util.HashMap;
import java.util.Map;

// Setup Client using Config object
Config config = new Config()
    .environment(Environment.TEST) // Or Environment.LIVE
    .apiKey("YOUR_API_KEY");
Client client = new Client(config);

// Create RequestOptions
HashMap<String, String> additionalHeaders = new HashMap<>();
additionalHeaders.put("X-Custom-Header", "custom-value");

RequestOptions requestOptions = new RequestOptions()
    .idempotencyKey("YOUR_IDEMPOTENCY_KEY") // use UUID
    .additionalServiceHeaders(additionalHeaders);

PaymentsApi paymentsApi = new PaymentsApi(client);

// Create PaymentRequest (example from existing README)
CardDetails cardDetails =
    new CardDetails()
      .type(CardDetails.TypeEnum.SCHEME)
      .encryptedCardNumber("5136333333333335")
      .holderName("John Doe")
      .cvc("737")
      .encryptedExpiryMonth("08")
      .encryptedExpiryYear("2018");
PaymentRequest paymentRequest =
  new PaymentRequest()
      .merchantAccount("YOUR_MERCHANT_ACCOUNT")
      .reference("YOUR_REFERENCE")
      .amount(new Amount()
          .currency("EUR")
          .value(1000L))
      .returnUrl("https://your-company.example.org/checkout?shopperOrder=12xy..")
      .paymentMethod(new CheckoutPaymentMethod(cardDetails));

// Make a call to the /payments endpoint with RequestOptions
PaymentResponse paymentResponse = paymentsApi.payments(paymentRequest, requestOptions);

// Process paymentResponse
System.out.println("Payment response: " + paymentResponse.toJson());

// Import the required model class
import com.adyen.model.checkout.PaymentRequest;

// Deserialize using built-in function
PaymentRequest paymentRequest = PaymentRequest.fromJson("YOUR_JSON_STRING");

// Import the required classes
import java.util.List;
import com.adyen.util.HMACValidator;
import com.adyen.notification.WebhookHandler;
import com.adyen.model.notification.NotificationRequest;
import com.adyen.model.notification.NotificationRequestItem;

// YOUR_HMAC_KEY from the Customer Area
String hmacKey = "YOUR_HMAC_KEY";
// The webhook payload
String notificationRequestJson = "NOTIFICATION_REQUEST_JSON";

HMACValidator hmacValidator = new HMACValidator();

WebhookHandler webhookHandler = new WebhookHandler();
NotificationRequest notificationRequest = webhookHandler.handleNotificationJson(notificationRequestJson);

// fetch first (and only) NotificationRequestItem
var notificationRequestItem = notificationRequest.getNotificationItems().stream().findFirst();

if (notificationRequestItem.isPresent()) {
    // validate the HMAC signature
    if ( hmacValidator.validateHMAC(notificationRequestItem, hmacKey) ) {
      // Process the notification based on the eventCode
      log.info("Received webhook with event {} : \n" +
        "Merchant Reference: {}\n" +
        "Alias : {}\n" +
        "PSP reference : {}", 
        notificationRequestItem.getEventCode(), 
        notificationRequestItem.getMerchantReference(),
        notificationRequestItem.getAdditionalData().get("alias"),
        notificationRequestItem.getPspReference());
    } else {
      // Non valid NotificationRequest
	  throw new RuntimeException("Invalid HMAC signature");
    }
}

// The webhook payload
String payload = "WEBHOOK_JSON_PAYLOAD";
// HMAC key from Customer Area
String hmacKey = "HMAC_KEY_RETRIEVED_FROM_CA";

// HMAC signature from hmacsignature header
String hmacsignature = headers.get("hmacsignature");
if (hmacsignature == null || hmacsignature.isBlank()) {
   throw new RuntimeException("HMAC Signature not found");
}

// validate the HMAC signature
HMACValidator hmacValidator = new HMACValidator();
if (!hmacValidator.validateHMAC(hmacsignature, hmacKey, payload)) {
   throw new RuntimeException("Invalid HMAC signature");
}

ConfigurationWebhooksHandler webhookHandler = new ConfigurationWebhooksHandler(payload);
// onAccountHolderNotificationRequest
webhookHandler.getAccountHolderNotificationRequest().ifPresent((AccountHolderNotificationRequest event) -> {
    System.out.println(event.getData().getBalancePlatform());
});
// onBalanceAccountNotificationRequest
webhookHandler.getBalanceAccountNotificationRequest().ifPresent((BalanceAccountNotificationRequest event) -> {
    System.out.println(event.getData().getBalanceAccount());
});

ManagementWebhooksHandler webhookHandler = new ManagementWebhooksHandler(payload);
// onMerchantCreatedNotificationRequest
webhookHandler.getMerchantCreatedNotificationRequest().isPresent((MerchantCreatedNotificationRequest event) -> {
System.out.println(event.getData().getMerchantId());
});

...
// Import the required classes
import com.adyen.httpclient.AdyenHttpClient;
import java.net.InetSocketAddress;
import java.net.Proxy;

// Set http proxy
AdyenHttpClient adyenHttpClientWithProxy = new AdyenHttpClient();

Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("PROXY_HOST", PROXY_PORT));
adyenHttpClientWithProxy.setProxy(proxy);

client.setHttpClient(adyenHttpClientWithProxy);

System.setProperty("https.proxyHost", "129.0.0.1");
System.setProperty("https.proxyPort", "3128");
System.setProperty("https.proxyUser", "squid");
System.setProperty("https.proxyPassword", "ward");

// Example: Configure timeouts via Config object
Config config = new Config()
    .environment(Environment.LIVE)
    .liveEndpointUrlPrefix("myCompany")
    .apiKey("YOUR_API_KEY")
    .connectionTimeoutMillis(10000)   // 10 sec to establish connection
    .readTimeoutMillis(15000)         // 15 sec max to receive a response
    .connectionRequestTimeoutMillis(5000); // 5 sec to acquire a pooled connection

Client client = new Client(config);

// Or use the convenience method on the Client object
client.setTimeouts(10000, 15000);

// Import the required classes
import com.adyen.Client;
import javax.net.ssl.KeyManagerFactory;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManagerFactory;
import java.security.KeyStore;

// Initialize a KeyManagerFactory with the client KeyStore and password
KeyManagerFactory keyManagerFactory = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());
keyManagerFactory.init(clientKeyStore, clientKeyStorePassword);

// Create a TrustManagerFactory that trusts the CAs in our Trust KeyStore
TrustManagerFactory trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
trustManagerFactory.init(trustStore);

// Create an SSLContext with the desired protocol that uses our KeyManagers and TrustManagers
SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
sslContext.init(keyManagerFactory.getKeyManagers(), trustManagerFactory.getTrustManagers(), null);

Client client = new Client(sslContext, apiKey);
// Use the client