eu.payzen.webservices.sdk.Payment Maven / Gradle / Ivy
Show all versions of payzen-ws-sdk Show documentation
/*
* Copyright 2015-2018 Javier Garcia Alonso.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package eu.payzen.webservices.sdk;
import java.util.Date;
import java.util.Map;
import com.lyra.vads.ws.v5.*;
import com.lyra.vads.ws.v5.CancelSubscriptionResponse.CancelSubscriptionResult;
import com.lyra.vads.ws.v5.CreateSubscriptionResponse.CreateSubscriptionResult;
import com.lyra.vads.ws.v5.CreateTokenFromTransactionResponse.CreateTokenFromTransactionResult;
import com.lyra.vads.ws.v5.GetSubscriptionDetailsResponse.GetSubscriptionDetailsResult;
import com.lyra.vads.ws.v5.ValidatePaymentResponse.ValidatePaymentResult;
/**
* Allows to perform payment related operations using the Payzen API based in
* SOAP Web Services.
* This SDK simplifies the usage of the API, handling the auth token calculation
* and giving a modern and simple interface.
*
* All the methods are represented by verbs, and they allow different modes for
* each operation:
*
* - Simple/Full mode: allows to perform a simple operation with simplified
* parameters or use instead a complete mode which can be easily handled using
* object builders.
* - With/without response handler: the usage of a response handler allows
* to create easily a callback model which help to work with the result and
* is ready to work with new Java 8 features.
*
*
* @author Javier Garcia Alonso
*/
public final class Payment {
// Hide constructor
private Payment() {
}
/**
* Initializes singleton.
*/
private static class SingletonHolder {
private static final PaymentInstance INSTANCE = new PaymentInstance();
}
/**
* Gets instance
*
* @return
*/
private static PaymentInstance getInstance() {
return SingletonHolder.INSTANCE;
}
/**
* Creates a payment request using the common parameters in a simple way.
*
* Please read official documentation for more detailed information about parameters.
*
* @param orderId Optional, null is none. The order Id.
* @param amount Amount of the payment in cents
* @param currency used currency in ISO 4217
* @param cardNumber card number
* @param expMonth expiration month
* @param expYear expiration year
* @param cvvCode card verification code
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult create(String orderId, long amount, int currency, String cardNumber, int expMonth, int expYear, String cvvCode, Map ... config) {
return getInstance().createSimple((config.length>0)?config[0]:null, orderId, amount, currency, cardNumber, expMonth, expYear, cvvCode);
}
/**
* Creates a payment request using the common parameters in a simple way.
*
* Please read official documentation for more detailed information about parameters.
*
* @param orderId Optional, null is none. The order Id.
* @param amount Amount of the payment in cents
* @param currency used currency in ISO 4217
* @param cardNumber card number
* @param expMonth expiration month
* @param expYear expiration year
* @param cvvCode card verification code
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult create(String orderId, long amount, int currency, String cardNumber, int expMonth, int expYear, String cvvCode, ResponseHandler response, Map ... config) {
return getInstance().createSimple((config.length>0)?config[0]:null, orderId, amount, currency, cardNumber, expMonth, expYear, cvvCode, response);
}
/**
* Creates a payment request using the createPayment object
* Please read official documentation for more detailed information about parameter content.
*
* @param createPaymentRequest complex object with all the parameters for service call
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult create(CreatePayment createPaymentRequest, Map ... config) {
return getInstance().create((config.length>0)?config[0]:null, createPaymentRequest);
}
/**
* Creates a payment request using the {@link CreatePayment} object
*
* Please read official documentation for more detailed information about parameter content.
*
* @param createPaymentRequest complex object with all the parameters for service call
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult create(CreatePayment createPaymentRequest, ResponseHandler response, Map ... config) {
return getInstance().create((config.length>0)?config[0]:null, createPaymentRequest, response);
}
/**
* Creates a payment in the system after returning from ACS (payment 3DS) .
*
* Please read official documentation for more detailed information about parameters.
*
* @param paRes Response from ACS
* @param MD Payment session information
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult create(String paRes, String MD, Map ... config) {
return getInstance().create3DS((config.length>0)?config[0]:null, paRes, MD);
}
/**
* Creates a payment in the system after returning from ACS (payment 3DS) .
*
* Please read official documentation for more detailed information about parameters.
*
* @param paRes Response from ACS
* @param MD Payment session information
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult create(String paRes, String MD, ResponseHandler response, Map ... config) {
return getInstance().create3DS((config.length>0)?config[0]:null, paRes, MD, response);
}
/**
* Get all the details of an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult details(String uuidTransaction, Map ... config) {
return getInstance().detailsSimple((config.length>0)?config[0]:null, uuidTransaction);
}
/**
* Get all the details of an existing transaction using the three key field that identify a transaction uniquely
* Please read official documentation for more detailed information about parameter content.
*
* @param transactionId the transaction id number
* @param creationDate the creation date. It only takes the day into account
* @param sequenceNumber the sequence number in case o multiple payment. Always 1 in case of simple payment
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult details(String transactionId, Date creationDate, int sequenceNumber, Map ... config) {
return getInstance().detailsByFind((config.length>0)?config[0]:null, transactionId, creationDate, sequenceNumber);
}
/**
* Get all the details of an existing transaction using the UUID of the transaction
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult details(String uuidTransaction, ResponseHandler response, Map ... config) {
return getInstance().detailsSimple((config.length>0)?config[0]:null, uuidTransaction, response);
}
/**
* Get all the details of an existing transaction using the three key field that identify a transaction uniquely
* Please read official documentation for more detailed information about parameter content.
*
* @param transactionId the transaction id number
* @param creationDate the creation date. It only takes the day into account
* @param sequenceNumber the sequence number in case o multiple payment. Always 1 in case of simple payment
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult details(String transactionId, Date creationDate, int sequenceNumber, ResponseHandler response, Map ... config) {
return getInstance().detailsByFind((config.length>0)?config[0]:null, transactionId, creationDate, sequenceNumber, response);
}
/**
* Get all the details of an existing transaction using the order Id As the order Id is not unique, we can have
* several transactions as response.
* Please read official documentation for more detailed information about parameter content.
*
* @param orderId the order Id
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult detailsByOrderId(String orderId, Map ... config) {
return getInstance().detailsByFind((config.length>0)?config[0]:null, orderId);
}
/**
* Get all the details of an existing transaction using the order Id As the order Id is not unique, we can have
* several transactions as response.
* Please read official documentation for more detailed information about parameter content.
*
* @param orderId the order Id
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult detailsByOrderId(String orderId, ResponseHandler response, Map ... config) {
return getInstance().detailsByFind((config.length>0)?config[0]:null, orderId, response);
}
/**
* Cancel an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult cancel(String uuidTransaction, Map ... config) {
return getInstance().cancelSimple((config.length>0)?config[0]:null, uuidTransaction);
}
/**
* Cancel an existing transaction using the three key field that identify a transaction uniquely
* Please read official documentation for more detailed information about parameter content.
*
* @param transactionId the transaction id number
* @param creationDate the creation date. It only takes the day into account
* @param sequenceNumber the sequence number in case o multiple payment. Always 1 in case of simple payment
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult cancel(String transactionId, Date creationDate, int sequenceNumber, Map ... config) {
return getInstance().cancelByFind((config.length>0)?config[0]:null, transactionId, creationDate, sequenceNumber);
}
/**
* Cancel an existing transaction using the UUID of the transaction
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult cancel(String uuidTransaction, ResponseHandler response, Map ... config) {
return getInstance().cancelSimple((config.length>0)?config[0]:null, uuidTransaction, response);
}
/**
* Cancel an existing transaction using the three key field that identify a transaction uniquely
* Please read official documentation for more detailed information about parameter content.
*
* @param transactionId the transaction id number
* @param creationDate the creation date. It only takes the day into account
* @param sequenceNumber the sequence number in case o multiple payment. Always 1 in case of simple payment
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult cancel(String transactionId, Date creationDate, int sequenceNumber, ResponseHandler response, Map ... config) {
return getInstance().cancelByFind((config.length>0)?config[0]:null, transactionId, creationDate, sequenceNumber, response);
}
/**
* Updates an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param amount the new amount for the transaction
* @param currency the currency of the transaction
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult update(String uuidTransaction, long amount, int currency, ResponseHandler response, Map ... config) {
return getInstance().updateSimple((config.length>0)?config[0]:null, uuidTransaction, amount, currency);
}
/**
* Updates an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param amount the new amount for the transaction
* @param currency the currency of the transaction
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult update(String uuidTransaction, long amount, int currency, Map ... config) {
return getInstance().updateSimple((config.length>0)?config[0]:null, uuidTransaction, amount, currency);
}
/**
* Updates an existing transaction using the {@link UpdatePayment} object
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param captureDate the new capture date for the transaction
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult update(String uuidTransaction, Date captureDate, ResponseHandler response, Map ... config) {
return getInstance().updateSimple((config.length>0)?config[0]:null, uuidTransaction, captureDate);
}
/**
* Validate an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param comment commentary to add to history
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult validate(String uuidTransaction, String comment, Map ... config) {
return getInstance().validatePayment((config.length>0)?config[0]:null, uuidTransaction, comment);
}
/**
* Validate an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param comment commentary to add to history
* @param response callback handler to work with the response
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult validate(String uuidTransaction, String comment, ResponseHandler response, Map ... config) {
return getInstance().validatePayment((config.length>0)?config[0]:null, uuidTransaction, comment);
}
/**
* Create a token using the card data an existing transaction using the UUID of the transaction
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param comment commentary to add to history
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult createToken(String uuidTransaction, String comment, Map ... config) {
return getInstance().createTokenFromTransaction((config.length>0)?config[0]:null, uuidTransaction, comment);
}
/**
* Refund a payment using the transaction UUID
*
* Please read official documentation for more detailed information about parameter content.
*
* @param uuidTransaction unique identifier of the transaction
* @param amount Amount to refund in cents
* @param currency used currency in ISO 4217
* @param comment commentary to add to history
* @param config OPTIONAL, allows to override configuration at runtime
* @return result with all the response objects
*/
@SafeVarargs
public static ServiceResult refund(String uuidTransaction, long amount, int currency, String comment, Map ... config) {
return getInstance().refund((config.length>0)?config[0]:null, uuidTransaction, amount, currency, comment);
}
}