No momento, esta página não está disponível em português
Reporting-2 icon

Dynamic sales day closing time

Change the sales day closing time for a specific night.

Every day, Adyen automatically closes the sales day at the same, static time. If in your own systems you often close the sales day at different times, you can dynamically change the sales day closing time with an API request whenever needed. This prevents reconciliation issues.

How it works

Hotels and restaurants use a nightly process called the 'Night Audit'. The night auditor closes the sales day in the business application that the hotel or restaurant uses, like a Property Management System (PMS), and opens the next sales day. The time when this takes place can be different each night based on the activity in the hotel or restaurant.

Your Adyen merchant account also has a sales day closing time. This determines in which settlement details report and payable batch the payments of the day end up. The closing time for your account is a static time, by default set to midnight, which is the earliest possible closing time. It is possible to change this static time, but not every day.

If the sales day closing time of your merchant account and the sales day closing time in your business application do not correspond, this causes reconciliation problems. To prevent reconciliation problems, you can send an API request every night to set the sales day closing time to the time you send the request.

If on a particular night you do not send a request to close the sales day, or if you send the request too late, we close the sales day at the static closing time.

Limitations

To benefit from dynamic sales day closing times:

  • Your merchant account must be set to Sales day payout T+1 or T+2.
    Because Sales day payout is not available in Africa, Brazil, and Turkey, dynamic sales day closing is also not available in those regions.
  • There must be a one-on-one relation between your merchant account and the business application where you close the sales day.

Dynamic sales day closing times do not solve reconciliation problems in the following situation:

  • You use several business applications, for example, a Food & Beverage POS system as well as a PMS.
    AND
  • You consolidate the payments from those applications to a single merchant account.
    AND
  • You close the sales day in those applications at different times.

Before you begin

To be able to use dynamic sales day closing times:

  1. In your Customer Area, change the static closing time for your merchant account to a time after midnight. We recommend using the latest possible time, which is 6:00 AM. This ensures the sales day is not already closed when you try to close it through your API request.

    Follow the instructions in Change how you get paid, using the following settings:

    • At Payout model, select Sales day payout, and T+1 or T+2.
    • At Timezone configuration, set the Closing time to, for example, 06:00.

  2. Make sure that you have an API credential with an API key and the following role:

    • Management API—Sales Day Payout read and write

Change the closing time for this night

To set the sales day closing time for a particular night, you need to send your request on time: after midnight, but before 6:00 AM in your time zone or the static closing time for your merchant account if that is earlier than 6:00 AM.

To close the sales day:

  1. Make a POST request to the /merchants/{merchantId}/closeSalesDay endpoint of Management API.

    It is optional to add a request body. If you want, you can specify:

    • closeNow: true.

    Sending the request without request body, with closeNow: true, or with closeNow: false will have the same effect: the sales day is closed at the time of sending the request.

  2. Check if your request succeeded.

    If your request failed, see Troubleshooting.

The next day, the sales day closing time for that night defaults to the static closing time of your merchant account, unless you send a new request.

Troubleshooting

If the /merchants/{merchantId}/closeSalesDay request fails, the title and detail in the error response indicate what happened. The following example shows the most common error:

This error can mean the following:

  • You already sent a sales day closing request for the same night.
  • You sent the request before midnight. To be precise: you sent the request between 6:00 AM or the static closing time for your account, and the earliest possible closing time of midnight. This can happen, for example, when you test the feature during the day.

Booking of payments

When you send a request to close the sales day:

  • Any payments captured before the time you sent the request to close the sales day, end up in the settlement details report for that sales day.
  • Any payments captured after the time you sent the request to close the sales day, are booked to the payable pending batch for the next sales day. That means they end up in the settlement details report for the next day.

See also