Posting transactions on holidays

When posting transactions, all configured calendars, holidays, and parameters are taken into consideration. The transaction types available for posting on holidays include:

  • Regular posting
  • Back-dated transaction
  • Future-dated transaction
  • Scheduled payment
  • Earmark
  • Multi-leg payment
  • Bulk payment

For back-dated transactions, you must provide business_date and payment_datetime fields in Post payment with a past date. For future-dated transactions, you can provide business_date and payment_datetime or specify desired parameter values in the metadata fields of administrative division or holidays. Note that the parameters set in the holiday or administrative division metadata can affect transaction approval as well as posting dates.

Parameters

To process dated transactions, you must specify the following parameters in the metadata when creating an administrative division or setting up holidays. Note that the metadata object does not have schema validation, so when there's a typographical error or a field isn't sent, the parameter value defaults to false.

Parameter nameData typePurpose
defer_transactionbooleanIndicates if transactions that occur on a holiday are deferred to the next business day. If not specified, defaults to false and transactions are not deferred.
deny_business_datebooleanDetermines whether transactions with a business date on a holiday are rejected. Defaults to false, permitting such transactions if not specified.
deny_value_datebooleanSpecifies whether to reject transactions with payment_datetime on a holiday. If not specified, defaults to false, allowing such transactions.
instant_clearingbooleanDetermines whether balances are immediately affected when a future business transaction is posted on a holiday. Defaults to false, indicating that if left unspecified, such transactions are allowed.
skip_cycle_closingbooleanDefines whether cycle closing is skipped on non-business days. If not specified, defaults to false and cycle closing is executed as usual.