Payout with type "FEE" in sandbox

Questions
,
1

Hi,

May I know how to trigger (create) a payout with entry in type “FEE“ (adjustment processing fee)? we would like to test whether our application could handle the type “FEE“ correctly.
Thanks.

Best Regards,
Alfred

2

:waving_hand: I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:

Additional Documentation

List Payout Entries
Refund a Payment with an Application Fee
Payments Pricing with Square APIs and SDKs

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.

3

To trigger a payout with an entry of type “FEE” (adjustment processing fee), you need to simulate a scenario where a Cost Plus pricing plan is in effect. Under the Cost Plus plan, Square charges an estimated fee at the time of each transaction, and at the end of the month, a one-time adjustment is made to capture the final fee. This adjustment is represented as a PayoutEntry with the type “FEE.”

To test this in your application, you would typically need to:

  1. Ensure that the seller account is set up with a Cost Plus pricing plan.
  2. Process transactions that incur estimated fees.
  3. Wait for the end-of-month adjustment, where Square reconciles the estimated fees with the actual fees, resulting in a PayoutEntry of type “FEE.”

Unfortunately, you cannot manually create a PayoutEntry of type “FEE” through the API for testing purposes. Instead, you would need to simulate the entire process as described above in a real or sandbox environment where Cost Plus pricing is applicable.

If you are testing in a sandbox environment, ensure that your application can handle and correctly process PayoutEntry objects with the type “FEE” when they are generated as part of the normal reconciliation process.

This answer was reviewed by @Bryan-Square.

4

The Cost Plus pricing plan is already in effect in our Square account, I can see the payout entry with type “FEE” in Square production env, in the payout happened around Jan 10th.

However I checked all the payout entries in Square sandbox env but can’t find the payout entry with type “FEE“, may I have your help please? the sandbox application id is “sandbox-sq0idb-_9Ox2CLpXcAcgfF4qgYcLw”;

Thanks in advance.

5

Unfortunately, replicating cost plus fees in sandbox isn’t currently available. :slight_smile:

1 Like