Dwolla

API / Facilitator Fee

Pocket a cut of the transaction

The facilitator fee is the application feature which allows a percentage or flat rate amount removed from every transaction as a fee and sent to the creator of the application. This fee comes out of the transaction total and is not appended to the transaction total itself. This is similar to how the Dwolla fee works. The facilitator fee cannot exceed 50% of the total transaction and must be at least $0.01. The facilitator fee can be overridden or turned off for each transaction by setting the facilitatorAmount property.

Setup the Facilitator Fee

The facilitator fee is setup per application through the application's feature page.

  • Create a Dwolla Consumer Application.
  • View your applications.
  • Click 'Edit Features' link.
  • Set the desired facilitator fee.

Setting the Facilitator Fee

If configured, the facilitator fee will be in addition to Dwolla's standard $0.25 flat-fee per transaction, and will credit the balance of the Dwolla account tied to the Consumer application.

  • Percent - This is a percentage of the transaction that the facilitator receives. It must not exceed 50% of the total transaction.
  • Fixed Rate - This is a flat amount per transaction that will be charged as a fee. It must not exceed 50% of the total transaction and must be at least $0.01.

When the application facilitates a transaction (send money, request money, payments workflow, etc.), that application's facilitator fee will be applied and the user who will receive the facilitator fee is the creator of the application.

The facilitator fee can only be applied when the application is facilitating a transaction whose recipient is an identity already tied to a Dwolla account at the time of the transaction. For example, if your application facilitates a payment from a Dwolla user to a Twitter identity not yet tied to a Dwolla account, the facilitator fee cannot be applied. This is necessary because Dwolla cannot guarantee the sender nor the facilitator that the recipient will act & claim the payment tied to the Twitter identity.

Modify the Facilitator Fee

The facilitator fee can be modified by setting the facilitatorAmount property on a per transaction basis. The Off-Site Gateway, Send, and Request endpoints all support this option. Two options are:

1. Override the Facilitator Fee

Setting the facilitatorAmount property to a fixed rate, the facilitator fee can be set to a higher or lower amount for each transaction. The minimum allowable amount is $0.01 and the maximum allowable amount is 50% of the transaction.

Send example

{
	"pin": "1111",
	"destinationId": "812-111-1111",
	"amount": 1,
	"facilitatorAmount": 0.05,
	"notes": "Test"
}

2. Disable the Facilitator Fee

Setting the facilitatorAmount property to a value of '0', the facilitator fee can be disabled for each transaction.

{
	"pin": "1111",
	"destinationId": "812-111-1111",
	"amount": 1,
	"facilitatorAmount": 0,
	"notes": "Test"
}