Paysimple - Java

Introduction

Paysimple is an online payment processing company that provides a platform for businesses to collect payments online. It supports a variety of payment methods such as credit/debit cards, ACH (Automated Clearing House) payment, and eCheck payment. Paysimple provides an easy-to-use API that allows developers to integrate payment processing with their websites or applications.

In this article, we will discuss how to use Paysimple's Java API for payment processing.

Getting Started

Sign up for a Paysimple account

Before you start using Paysimple's Java API, you need to sign up for a Paysimple account. You can do it by visiting the Paysimple website and clicking on the "Try Paysimple" button.

Set up your Paysimple account

Once you have signed up for an account, you need to configure your Paysimple account to use the API. To do this, follow these steps:

1. Log in to your Paysimple account.
2. Click on the "API Access" tab.
3. Generate an API key and secret.
4. Copy the API key and secret and store them in a secure location.

Add the Paysimple Java API to your project

To use Paysimple's Java API, you need to add the Paysimple Java SDK to your project. You can do it by adding the following dependency to your project's pom.xml file if you are using Maven:

<dependency>
    <groupId>com.paysimple</groupId>
    <artifactId>paysimple-sdk-java</artifactId>
    <version>1.0.0</version>
</dependency>

If you are using Gradle, add the following to your build.gradle file:

compile group: 'com.paysimple', name: 'paysimple-sdk-java', version: '1.0.0'

Initializing the Paysimple client

To use the Paysimple API for payment processing, you need to create an instance of the PaysimpleClient class. You can do it as follows:

String apiKey = "your-api-key-from-paysimple";
String apiSecret = "your-api-secret-from-paysimple";

PaysimpleClient paysimpleClient = new PaysimpleClient(apiKey, apiSecret);

List of supported API operations

Paysimple's Java API provides the following operations for payment processing:

• Create customer
• Get customer
• Update customer
• Delete customer
• Create payment
• Get payment
• Delete payment
• Search payments

Create customer

You can create a new customer record by using the paysimpleClient.customerService().create(CustomerRequest customerRequest) method. Here's an example:

String firstName = "John";
String lastName = "Doe";
String email = "john.doe@email.com";
String phone = "555-555-5555";

CustomerRequest customerRequest = new CustomerRequest.Builder()
        .firstName(firstName)
        .lastName(lastName)
        .email(email)
        .phone(phone)
        .build();

CustomerResponse customer = paysimpleClient.customerService().create(customerRequest);

System.out.println("Customer created with ID: " + customer.getId());

Get customer

You can retrieve a customer record by using the paysimpleClient.customerService().get(String customerId) method. Here's an example:

String customerId = "123456789";

CustomerResponse customer = paysimpleClient.customerService().get(customerId);

System.out.println("Customer ID: " + customer.getId());
System.out.println("Customer name: " + customer.getFirstName() + " " + customer.getLastName());
System.out.println("Customer email: " + customer.getEmail());

Update customer

You can update an existing customer record by using the paysimpleClient.customerService().update(String customerId, CustomerRequest customerRequest) method. Here's an example:

String customerId = "123456789";
String phone = "555-555-5555";

CustomerRequest customerRequest = new CustomerRequest.Builder()
        .phone(phone)
        .build();

CustomerResponse customer = paysimpleClient.customerService().update(customerId, customerRequest);

System.out.println("Customer phone updated to: " + customer.getPhone());

Delete customer

You can delete a customer record by using the paysimpleClient.customerService().delete(String customerId) method. Here's an example:

String customerId = "123456789";

paysimpleClient.customerService().delete(customerId);

System.out.println("Customer deleted with ID: " + customerId);

Create payment

You can create a new payment by using the paysimpleClient.paymentService().create(PaymentRequest paymentRequest) method. Here's an example:

String customerId = "123456789";
BigDecimal amount = new BigDecimal("100.00");
String paymentType = "creditcard";
String cardNumber = "4111111111111111";
String cardExpMonth = "12";
String cardExpYear = "2022";
String cvv = "123";

PaymentRequest paymentRequest = new PaymentRequest.Builder()
        .customerId(customerId)
        .amount(amount)
        .paymentType(paymentType)
        .cardNumber(cardNumber)
        .cardExpMonth(cardExpMonth)
        .cardExpYear(cardExpYear)
        .cvv(cvv)
        .build();

PaymentResponse payment = paysimpleClient.paymentService().create(paymentRequest);

System.out.println("Payment created with ID: " + payment.getId());

Get payment

You can retrieve a payment by using the paysimpleClient.paymentService().get(String paymentId) method. Here's an example:

String paymentId = "123456789";

PaymentResponse payment = paysimpleClient.paymentService().get(paymentId);

System.out.println("Payment ID: " + payment.getId());
System.out.println("Payment amount: " + payment.getAmount());
System.out.println("Payment status: " + payment.getStatus());

Delete payment

You can delete a payment by using the paysimpleClient.paymentService().delete(String paymentId) method. Here's an example:

String paymentId = "123456789";

paysimpleClient.paymentService().delete(paymentId);

System.out.println("Payment deleted with ID: " + paymentId);

Search payments

You can search for payments by using the paysimpleClient.paymentService().search(PaymentSearchRequest paymentSearchRequest) method. Here's an example:

LocalDate startDate = LocalDate.of(2020, 1, 1);
LocalDate endDate = LocalDate.now();
BigDecimal minAmount = new BigDecimal("50.00");
BigDecimal maxAmount = new BigDecimal("100.00");

PaymentSearchRequest paymentSearchRequest = new PaymentSearchRequest.Builder()
        .startDate(startDate)
        .endDate(endDate)
        .minAmount(minAmount)
        .maxAmount(maxAmount)
        .build();

PaymentSearchResponse paymentSearchResponse = paysimpleClient.paymentService().search(paymentSearchRequest);

for (PaymentResponse payment : paymentSearchResponse.getPayments()) {
    System.out.println("Payment ID: " + payment.getId());
    System.out.println("Payment amount: " + payment.getAmount());
    System.out.println("Payment status: " + payment.getStatus());
}

Conclusion

In this article, we have discussed how to use Paysimple's Java API for payment processing. We have covered the basic operations such as creating, retrieving, updating, and deleting customer and payment records. We have also discussed how to search for payments using various criteria. Paysimple provides a comprehensive API that allows developers to integrate payment processing with their websites or applications.