com.ning.billing.payment.api.PaymentApi Maven / Gradle / Ivy
/*
* Copyright 2010-2013 Ning, Inc.
*
* Ning licenses this file to you 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 com.ning.billing.payment.api;
import java.math.BigDecimal;
import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.UUID;
import com.ning.billing.account.api.Account;
import com.ning.billing.security.RequiresPermissions;
import com.ning.billing.util.callcontext.CallContext;
import com.ning.billing.util.callcontext.TenantContext;
import com.ning.billing.util.entity.Pagination;
import static com.ning.billing.security.Permission.INVOICE_CAN_ADJUST;
import static com.ning.billing.security.Permission.INVOICE_CAN_ITEM_ADJUST;
import static com.ning.billing.security.Permission.PAYMENT_CAN_CREATE_EXTERNAL_PAYMENT;
import static com.ning.billing.security.Permission.PAYMENT_CAN_REFUND;
import static com.ning.billing.security.Permission.PAYMENT_CAN_TRIGGER_PAYMENT;
public interface PaymentApi {
/**
* @param account the account
* @param invoiceId the invoice id
* @param amount the amount to pay
* @param context the call context
* @return the payment
* @throws PaymentApiException
*/
@RequiresPermissions(PAYMENT_CAN_TRIGGER_PAYMENT)
public Payment createPayment(Account account, UUID invoiceId, BigDecimal amount, CallContext context)
throws PaymentApiException;
/**
* @param account the account
* @param invoiceId the invoice id
* @param amount the amount to pay
* @param context the call context
* @return the payment
* @throws PaymentApiException
*/
@RequiresPermissions(PAYMENT_CAN_CREATE_EXTERNAL_PAYMENT)
public Payment createExternalPayment(Account account, UUID invoiceId, BigDecimal amount, CallContext context)
throws PaymentApiException;
/**
* @param account the account
* @param paymentId the payment id
* @param context
* @return
* @throws PaymentApiException
*/
public Payment retryPayment(Account account, UUID paymentId, CallContext context)
throws PaymentApiException;
/**
* Create a refund for a given payment. The associated invoice is not adjusted.
*
* @param account account to refund
* @param paymentId payment associated with that refund
* @param refundAmount amount to refund
* @param context the call context
* @return the created Refund
* @throws PaymentApiException
*/
@RequiresPermissions(PAYMENT_CAN_REFUND)
public Refund createRefund(Account account, UUID paymentId, BigDecimal refundAmount, CallContext context)
throws PaymentApiException;
/**
* @param refundId the refund id
* @param withPluginInfo whether to fetch plugin info
* @param context the call context @return the refund
* @throws PaymentApiException
*/
public Refund getRefund(UUID refundId, final boolean withPluginInfo, TenantContext context)
throws PaymentApiException;
/**
* Create a refund for a given payment. The associated invoice is adjusted.
*
* @param account account to refund
* @param paymentId payment associated with that refund
* @param refundAmount amount to refund
* @param context the call context
* @return the created Refund
* @throws PaymentApiException
*/
@RequiresPermissions({PAYMENT_CAN_REFUND, INVOICE_CAN_ADJUST})
public Refund createRefundWithAdjustment(Account account, UUID paymentId, BigDecimal refundAmount, CallContext context)
throws PaymentApiException;
/**
* Create a refund for a given payment. The specified invoice items are fully adjusted.
* The refund amount will be the sum of all invoice items amounts.
*
* @param account account to refund
* @param paymentId payment associated with that refund
* @param invoiceItemIds invoice item ids to adjust
* @param context the call context
* @return the created Refund
* @throws PaymentApiException
*/
@RequiresPermissions({PAYMENT_CAN_REFUND, INVOICE_CAN_ITEM_ADJUST})
public Refund createRefundWithItemsAdjustments(Account account, UUID paymentId, Set invoiceItemIds, CallContext context)
throws PaymentApiException;
/**
* Create a refund for a given payment. The specified invoice items are partially adjusted.
* The refund amount will be the sum of all adjustments.
*
* @param account account to refund
* @param paymentId payment associated with that refund
* @param invoiceItemIdsWithAmounts invoice item ids and associated amounts to adjust
* @param context the call context
* @return the created Refund
* @throws PaymentApiException
*/
@RequiresPermissions({PAYMENT_CAN_REFUND, INVOICE_CAN_ITEM_ADJUST})
public Refund createRefundWithItemsAdjustments(Account account, UUID paymentId, Map invoiceItemIdsWithAmounts, CallContext context)
throws PaymentApiException;
/**
* @param account the account
* @param context the call context
* @return the list of refund on this account
* @throws PaymentApiException
*/
public List getAccountRefunds(Account account, TenantContext context)
throws PaymentApiException;
/**
* @param paymentId the payment id
* @param context the call context
* @return the list of refund on this account
* @throws PaymentApiException
*/
public List getPaymentRefunds(UUID paymentId, TenantContext context)
throws PaymentApiException;
/**
* @param invoiceId the invoice id
* @param context the call context
* @return the list of payment on this invoice
* @throws PaymentApiException
*/
public List getInvoicePayments(UUID invoiceId, TenantContext context)
throws PaymentApiException;
/**
* @param accountId the account id
* @param context the call context
* @return the list of payment on this account
* @throws PaymentApiException
*/
public List getAccountPayments(UUID accountId, TenantContext context)
throws PaymentApiException;
/**
* @param paymentId the payment id
* @param withPluginInfo whether to fetch plugin info
* @param context the call context
* @return the payment
* @throws PaymentApiException
*/
public Payment getPayment(UUID paymentId, final boolean withPluginInfo, TenantContext context)
throws PaymentApiException;
/**
* @return a list of all the payment plugins registered
*/
public Set getAvailablePlugins();
/**
* @param pluginName the plugin name
* @param account the account
* @param setDefault whether this should be set as a default payment method
* @param paymentMethodInfo the details for the payment method
* @param context the call context
* @return the uuid of the payment method
* @throws PaymentApiException
*/
public UUID addPaymentMethod(String pluginName, Account account, boolean setDefault, PaymentMethodPlugin paymentMethodInfo, CallContext context)
throws PaymentApiException;
/**
* @param account the account id
* @param withPluginInfo whether we want to retrieve the plugin info for that payment method
* @param context the call context
* @return the list of payment methods
* @throws PaymentApiException
*/
public List getPaymentMethods(Account account, final boolean withPluginInfo, TenantContext context)
throws PaymentApiException;
/**
* @param paymentMethodId the payment methid id
* @param includedInactive returns the payment method even if this is not active
* @param withPluginInfo whether we want to retrieve the plugin info for that payment method
* @param context the call context @return the payment method
* @throws PaymentApiException
*/
public PaymentMethod getPaymentMethodById(UUID paymentMethodId, final boolean includedInactive, final boolean withPluginInfo, TenantContext context)
throws PaymentApiException;
/**
* Find all payment methods across all plugins
*
* @param offset the offset of the first result
* @param limit the maximum number of results to retrieve
* @param context the user context
* @return the list of payment methods for that tenant
*/
public Pagination getPaymentMethods(Long offset, Long limit, TenantContext context);
/**
* Find all payment methods in a given plugin
*
* @param offset the offset of the first result
* @param limit the maximum number of results to retrieve
* @param pluginName the payment plugin name
* @param context the user context
* @return the list of payment methods for that tenant
* @throws PaymentApiException
*/
public Pagination getPaymentMethods(Long offset, Long limit, String pluginName, TenantContext context) throws PaymentApiException;
/**
* Find all payment methods matching the search key across all plugins
*
* The match will be plugin specific: for instance some plugins will try to match the key
* against the last 4 credit cards digits, agreement ids, etc.
*
* @param searchKey the search key
* @param offset the offset of the first result
* @param limit the maximum number of results to retrieve
* @param context the user context
* @return the list of payment methods matching this search key for that tenant
*/
public Pagination searchPaymentMethods(String searchKey, Long offset, Long limit, TenantContext context);
/**
* Find all payment methods matching the search key in a given plugin
*
* The match will be plugin specific: for instance some plugins will try to match the key
* against the last 4 credit cards digits, agreement ids, etc.
*
* @param searchKey the search key
* @param offset the offset of the first result
* @param limit the maximum number of results to retrieve
* @param pluginName the payment plugin name
* @param context the user context
* @return the list of payment methods matching this search key for that tenant
* @throws PaymentApiException
*/
public Pagination searchPaymentMethods(String searchKey, Long offset, Long limit, String pluginName, TenantContext context) throws PaymentApiException;
/**
* @param account the account
* @param paymentMethodId the id of the payment method
* @param deleteDefaultPaymentMethodWithAutoPayOff
* whether to allow deletion of default payment method and set account into AUTO_PAY_OFF
* @param context the call context
* @throws PaymentApiException
*/
public void deletedPaymentMethod(Account account, UUID paymentMethodId, boolean deleteDefaultPaymentMethodWithAutoPayOff, CallContext context)
throws PaymentApiException;
/**
* @param account the account
* @param paymentMethodId the payment method id
* @param context the call context
* @throws PaymentApiException
*/
public void setDefaultPaymentMethod(Account account, UUID paymentMethodId, CallContext context)
throws PaymentApiException;
/**
* @param pluginName the name of the plugin
* @param account the account
* @param context the call context
* @return the list of payment methods for that account
* @throws PaymentApiException
*/
public List refreshPaymentMethods(String pluginName, Account account, CallContext context)
throws PaymentApiException;
/**
* Refresh all payment methods across all plugins
*
* This call is not atomic.
*
* @param account the account
* @param context the call context
* @return the list of payment methods for that account
* @throws PaymentApiException
*/
public List refreshPaymentMethods(Account account, CallContext context)
throws PaymentApiException;
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy