Fees
optional - Identifies Processor being used by an API Partner
optional - Valid CharityId from Charity Search
internal use - Valid Panorama Organization Guid
internal use - Identifies integrated Product
Payment API Token GUID. Card Type of Token will be used in Fee Calculation. If using TokenGuid then do not set CreditCardTypeId parameter
required - transaction amount
required - API Partners should set to 10 if API Partner fees configured - possible values - 1 - Donation Fee, 2 - Peer-to-Peer Fee, 3 - Auction Performance Fee, 4 - Ticket Fee, 5 - Registration Fee, 6 - Quick Sales Fee, 7 - Online Store Fee, 8 - Campaign Fee, 9 - 0% Auction Performance Fee, 10 - ApiPartnerFee, 11 - ExpressPayrollFee; 12 - PaymentNoFee;
required - cover the fees flag for the transaction. Indicates if the donor intends to cover the processing fees for the donation
optional - The percentage value that you want to set for your commission on the transaction. Minimum value that will be used is the FrontStream Commission Rate as set in your contract, maximum value is the maximum commission rate set in your contract. Passing values outside of the min/max range will not result in a validation error, but will instead default to the min/max value (i.e. if your maximum commission rate in your contract is 10%, and you pass "15.0" for this value, the Payment API will simply use 10%). Not including this field or passing null also defaults to using the maximum commission rate from your contract.
optional - Overrides the default percentage processing fee
optional - An amount taken up front for the API Partner if Donor decides to apply a tip. Added to the total amount to charge on the donor’s card . Card fee calculations are performed using this value; all commission and credit card fees still apply as normal.
optional - A tax amount taken up front. Added to the total amount to charge on the donor’s card. Card fee calculations are performed using this value; all commission and credit card fees still apply as normal.
Used for API Partner's per card type fee calculation based on contract, For example - $0.30 per transaction for Visa, MasterCard and Discover cards and $0.50 per transaction for American Express. possible values - 1 - AMEX, 2 - MC, 3 - VISA, 4 - DISCOVER, 5 - DINERSCLUB, 7 - MAESTRO;
access token
Returns the calculated fees
This is the amount charged to the donor. Will be equal to the sum of the Amount parameters if payFee=false, but if payFee=true, then this will be the amount that will be charged to the donor in order to have the net post-disbursement donation be equal to the Amount parameters.
example 2.5% - applied to EVERY donation. This is the FrontStream card processing fee. The percentage of the PaymentAmount that will be taken for credit card fees. Expressed as a human-readable percentage rather than a decimal value, it is intended to be able to be displayed directly on a page without needing to be converted.
This is the amount that is owed to the gateway for the example 2.5% that FrontStream collects from the transaction. 2.5% of transaction amount if donor is not paying the fee, otherwise 2.5% of the transaction + card fee.
A per transaction fee configured by card type (VI, MC, DI, AMEX, etc.) per API Partner's Contract other wise 0 (zero)
The Total percentage of Commissions that FrontStream takes from a given transaction. This rate = Partner CommissionRate + FS CommissionRate
The product of the transaction times the Total commission rate.
The Partner Commission percentage taken on behalf of the Partner from a given transaction.
The product of the transaction times the Partner commission rate.
The FrontStream Commission percentage that FrontStream takes from a given transaction.
The product of the transaction times the FrontStream commission rate.
The sum of all fees applied to a transaction amount. (TotalCommission + CardFee + FlatFee + CardFeeOnFee)
The derived minimum partner override rate and maximum partner override rate
MaxOverridePartnerCommissionRate = TotalFees = (PartnerCommission rate) + (Card Fee Rate) + (Fs Commission Rate) MinOverridePartnerCommissionRate = (Card Fee rate) + (Fs Commission rate)
The flat amount that will be taken from the PaymentAmount for any Per-Transaction Fees as configured in your contract.
The flat amount that will be paid out to the API Partner if Donor decides to add a tip regardless of payFee true or false.
If fees calculation throws exception
If the fees are not found
Calculates Fees based on an array of Transaction Line items - Amount and Transaction Source Groupings
access token
optional - Identifies Processor being used by an API Partner
optional - Valid CharityId Guid from Charity Search
internal use - Valid Panorama Organization Guid
internal use - Identifies integrated Product
Payment API Token GUID. Card Type of Token will be used in Fee Calculation. If using TokenGuid then do not set CreditCardTypeId parameter
Returns the calculated fees
The total payment amount processed toward the cardholder's account.
The calculated total fees amount of the list of transactions.
The calculated total tax amount of the list of transactions.
If fees calculation throws exception
If the fees are not found
Last updated