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.

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"
}
comments powered by Disqus