Subscription blocking flow due to split mismatch

When a recurring charge is created or a subscription charge is received, the system checks whether the total split amount configured for the subscription exceeds the net amount to be received. If this occurs, the subscription will be blocked, the split will be disabled, and the creation of new recurring charges will also be stopped. In this scenario, a notification will be sent via webhook, informing—through the additionalInfo property in the message body—about the block and granting a period of 2 business days to adjust either the split or the subscription amount.

If the split or subscription amount is adjusted within the given period and the new total split amount is equal to or less than the subscription’s net amount, the block will be lifted, allowing the subscription to be restored and new charges to be generated with the updated split.

However, if no adjustment is made within the established period, the block will automatically end due to expiration, and the split will remain disabled. In this case, a new notification will be sent via webhook to inform about the block expiration. In the body of this notification, within the additionalInfo property, a message will be included detailing that the subscription has been unblocked and that new recurring charges will be created without the configured split.

Webhook events used for communication:

  • For the blocking flow: SUBSCRIPTION_SPLIT_DIVERGENCE_BLOCK
  • For the unblocking flow due to expiration: SUBSCRIPTION_SPLIT_DIVERGENCE_BLOCK_FINISHED