Facilitator Fee
Charge users a flat rate amount to be removed from a payment as a fee. The fee is sent to the creator of the application.
Overview
The facilitator fee is a feature allowing for a flat rate amount to be removed from a payment as a fee, and sent to the creator of the Dwolla application. The fee does not affect the original payment amount, and exists as a separate Transfer resource with a unique transfer ID.
Items to note before charging fees:
- Fees cannot be applied on me-to-me transfers where the source is the Customer’s Dwolla Balance
- Facilitator fees can be debited from either the sending or receiving user of the payment
- The sum of fees cannot exceed 50% of the original transfer amount
This limit can be removed upon further approval from the Dwolla team. If approved, only the sender of the transfer can be charged fees that exceed 50% of the transfer amount. Furthermore, the sum of fees cannot exceed the transaction limit of the sender. Please contact support@dwolla.com or your account manager for approval.
- A facilitator fee must be at least $0.01
- Multiple facilitator fees can be associated with a single payment
- You must clearly communicate the fee and its payment terms to your end user and obtain the user’s express consent to charge the fee
Charging fees on transfers
Fees are programmatically set on an individual transfer API request. Within a transfer request you can specify an optional fees request parameter, which is an array of fee objects that can represent many unique fee transfers. If your platform wishes to charge a percentage of the total transfer amount then your application will need to compute the percentage prior to initiating the transfer request. Note: Fees must be deducted from one of the accounts that is involved in either sending or receiving the funds for a transfer (not an alternative account).
A fee object is made up of a _links and an amount JSON object. The _links object contains charge-to, which represents the associated source or destination Customer or Account resource that will assume the fee. The amount object contains value and currency keys corresponding to the fee amount and USD respectively.
When a facilitator fee is added to a transfer request, it is treated as a separate transfer which does not affect a Customer’s weekly, or per transaction limit.
A fee object:
Example transfer request:
Retrieve fees charged on a transfer
Once a transfer is successfully created, subsequent transfers will be created that represent the associated fees on that transfer. These fees will not be charged until the transfer processes successfully to the destination user. In the event of a failed or cancelled payment no fees will be charged.
Example Get a transfer’s fees request:
Reconciling fees
Since a fee is a separate transfer in itself, it will show up in the transfer listing of either the Account or Customer resource, depending on which party is sending or receiving the fee. To correlate a fee to the transfer that the fee was charged on, a key of created-from-transfer will be returned in the list of links on a unique transfer resource. The created-from-transfer key can also be used to differentiate a fee from other transfer types.
Refunding fees:
Within the Dwolla API, an endpoint does not exist to refund a processed transfer from the receiving user or account back to the sending party—this includes fees if any were charged. Refunds occur by the destination user initiating a separate transfer in reverse from the funding source in which they received the funds. As a facilitator who received funds from the fee, you must determine if the charged user will incur the cost of the fee or be refunded for the original fee amount charged.