You can now customize the ID of a Business Process by providing a unique idSeed during creation. This seed allows the system to generate a deterministic UUID (v5) for the Business Process.

Why Use `idSeed`?

Batch Integrations: When processing multiple Business Processes at once, you can specify an idSeed to ensure consistent and predictable IDs across different systems. For example, you can use the same seed to create related events like reminders or to resolve Business Processes by referencing the deterministic ID.

Prevent Duplicate Creations: By using the same idSeed, you can avoid creating duplicate Business Processes, as the system will generate the same UUID for identical seeds.

API Integration

This new feature is integrated with the following API endpoints:

Create Business Process:

POST /merchants/{merchant-id}/business-processes Try here.

Examples:

Supply the idSeed in your payload to create a Business Process with a custom deterministic ID.

{
 "idSeed": "red-mclaren-rd",
 "actions": [...],
 "...": ".."
}

{
 "idSeed": "mr-sayed-16",
 "actions": [...],
 "...": ".."
}

Fetch Business Process:

GET /merchants/{merchant-id}/business-processes/seed:{seed-value} Try here.

Examples:

Retrieve the Business Process along with the idSeed used during creation.

wget https://api.authvia.com/v3/merchants/{merchant-id}/business-processes/seed:red-mclaren-rd
wget https://api.authvia.com/v3/merchants/{merchant-id}/business-processes/seed:mr-sayed-16