This endpoint is called by Integration Hub to notify downstream banking provider systems about product changes that occurred in the Wallet system. The endpoint should be implemented by third-party banking providers to receive and process product change notifications.
When this endpoint is called, it indicates that products associated with a customer have been modified in the Wallet system and need to be synchronized in the banking provider's system. The notification can contain:
-
Products to upsert: A list of products that should be created if they don't exist, or updated if they already exist in the provider's system. Each product contains complete information including account details, balances, status, and metadata.
-
Products to delete: A list of product IDs that should be removed from the provider's system. These are products that have been deleted or deactivated in the Wallet and should no longer be accessible.
The provider system receiving this notification should:
- Validate that the customerId corresponds to an existing customer in their system
- Process all product upserts by creating new products or updating existing ones based on the product ID
- Process all product deletions by removing or deactivating the specified products
- Return a successful response (HTTP 200) if all operations completed successfully
- Return an error response (HTTP 400/404) if validation fails or operations cannot be completed
The endpoint is idempotent - calling it multiple times with the same data should produce the same result. Product upserts should use the product ID as the unique identifier to determine whether to create or update.
This is a critical synchronization point to ensure consistency between Toqio and the integration products catalog for each customer.