/*
* 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.util.callcontext.CallContext;
import com.ning.billing.util.callcontext.TenantContext;
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
*/
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
*/
public Payment createExternalPayment(Account account, UUID invoiceId, BigDecimal amount, 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
*/
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
*/
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
*/
public Refund createRefundWithItemsAdjustments(Account account, UUID paymentId, Set<UUID> 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
*/
public Refund createRefundWithItemsAdjustments(Account account, UUID paymentId, Map<UUID, BigDecimal> 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<Refund> 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<Refund> 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<Payment> 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<Payment> 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<String> 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<PaymentMethod> 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;
/**
* @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<PaymentMethod> refreshPaymentMethods(String pluginName, Account account, CallContext context)
throws PaymentApiException;
}