FrontStream Docs
FrontStream Payments
FrontStream Payments
  • Introducing our Embedded Form
    • Overview and Features
    • Payment Methods process
    • How to implement
    • Compare Embedded Form and Direct API integration
  • Welcome to our Payment API
    • Overview
    • Quick Start
    • API references
      • Search for a Charity for your Donation
      • Make a Payment
      • Learn how to cover Fees
      • Test Payment API Features
        • CharitySearch
        • Payment
        • Fee
      • Temp - Make a Payment - API specification
      • Temp - Charity Search API specification
      • Payment - Specification
      • Calculate Fees - Specification
    • Specification
    • CharitySearch - Specification
Powered by GitBook
On this page
Export as PDF
  1. Welcome to our Payment API
  2. API references
  3. Test Payment API Features

Fee

PreviousPaymentNextTemp - Make a Payment - API specification

Last updated 4 months ago

To try a test and directly interact with the API endpoint click "Test It" and use an embedded API client to send requests with custom headers and variables, then see the live response; essentially letting you test this API directly within this page. When testing please use our Demo URL: https://demo-payments.frontstream.com/api/fee

Page cover image

Calculates Fees based on Amount and Transaction Source Grouping

get
Query parameters
ProcessorGuidstringOptional

required - Identifies Processor being used by an API Partner

CharityIdstringOptional

optional - Valid CharityId from Charity Search

OrganizationGuidstringOptional

internal use - Valid Panorama Organization Guid

IntegrationSourceGuidstringOptional

internal use - Identifies integrated Product – PAN, Firstgiving, Artez, BFG, and can also be an Api Partner

TokenGuidstringOptional

Payment API Token GUID. Card Type of Token will be used in Fee Calculation. If using TokenGuid then do not set CreditCardTypeId parameter

Amountstring · max: 7Required

required - transaction amount

TransactionSourceGroupIdstringRequired

required - Api Partners should set to 10 - 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;

PayFeebooleanRequired

required - cover the fees flag for the transaction

CommissionRateOverridenumber · doubleOptional

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.

CardProcessingFeeOverridenumber · doubleOptional

optional - Overrides the default percentage processing fee

Tipstring · max: 7Optional

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.

CreditCardTypeIdstringOptional

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.

Header parameters
AccessTokenstringRequired

access token

Responses
200
Returns the calculated fees
application/json
400
If fees calculation throws exception
application/json
404
If the fees are not found
application/json
get
GET /api/fee?Amount=text&TransactionSourceGroupId=text&PayFee=true HTTP/1.1
Host: 
AccessToken: text
Accept: */*
{
  "TransactionSourceGroupId": "text",
  "PaymentAmount": 1,
  "CardFeeRate": 1,
  "CardFeeAmount": 1,
  "CardTypeFeeAmount": 1,
  "TotalCommissionRate": 1,
  "TotalCommissionAmount": 1,
  "PartnerCommissionRate": 1,
  "PartnerCommissionAmount": 1,
  "FsCommissionRate": 1,
  "FsCommissionAmount": 1,
  "TotalFees": 1,
  "MaxOverridePartnerCommissionRate": 1,
  "MinOverridePartnerCommissionRate": 1,
  "PerTransFee": 1,
  "Tip": 1,
  "CardFeeOnFeeAmount": 1
}