Before you start
Make sure you have access to the Fiskil Console with appropriate permissions for Product Portal.
All product changes follow a controlled workflow: create or edit in Staging, review and approve, then publish to Production.
Product lifecycle overview
Every product in Product Portal follows a consistent lifecycle:1
Create or edit
Add a new product or make changes to an existing one. All changes start in draft mode.
2
Review and validate
Review your changes in the Console. Validation errors are shown inline before you can proceed.
3
Deploy to Staging
Deploy your product to the Staging environment for testing. You can verify the product data through the API.
4
Approve and publish
Once validated, approve the changes and publish to Production. This makes the product available to data recipients.
Creating a new product
1
Navigate to Product Portal
In the Fiskil Console, go to Product Portal from the main navigation.
2
Click Add New Product
Select + Add New Product to open the product form.
3
Complete required fields
Fill in the mandatory product details:
| Field | Description |
|---|---|
| Product ID | Unique identifier (e.g., savings-account-001) |
| Product name | Display name shown to customers |
| Product category | Category from the regulated specification |
| Description | Short public description of the product |
See the Product fields reference for a complete list of all available fields.
4
Add optional details
Expand additional sections to configure:
- Features — capabilities like digital banking, offset accounts
- Eligibility — who can apply for the product
- Fees — charges and optional discounts
- Rates — deposit or lending rates with tiers
- Bundles — group products together
5
Save draft
Click Save to store your product as a draft. You can continue editing before deploying.
Editing an existing product
1
Find the product
Use the search or filter options in Product Portal to locate the product you want to edit.
2
Open the product
Click on the product row to open the product detail view.
3
Click Edit
Select Edit to enable editing mode. This creates a new draft version of the product.
4
Make your changes
Update any fields as needed. The form validates your changes in real time.
5
Save and review
Save your changes and review the diff to confirm what has changed.
Deploying to Staging
Before publishing to production, you should validate your changes in Staging.1
Review your draft
Open the product and review the pending changes. The Console shows a diff of what will be deployed.
2
Deploy to Staging
Click Deploy to Staging. This pushes your product data to the Staging environment.
3
Verify via API
Use the built-in Test API feature to verify your product appears correctly:
- Click Test API in the top-right corner of Product Portal
- Select Staging as the environment
- Click Send Request to view your products
4
Fix any issues
If you find issues, return to the Console, edit the product, and redeploy to Staging.
Approving and publishing to Production
Once your product is validated in Staging, you can publish it to Production.1
Request approval
If your organisation uses approval workflows, submit the product for review.
2
Approve changes
An authorised approver reviews and approves the changes.
Approval workflows are configurable. Contact the Fiskil team to set up approval rules for your organisation.
3
Publish to Production
Click Publish to Production. The product is now live and accessible to data recipients.
Your product is now visible in the public Products API endpoint.
Scheduling product updates
Product Portal supports scheduling changes to go live at a future date and time.1
Prepare your changes
Edit the product and save your changes as a draft.
2
Set effective date
When deploying, select Schedule and choose the date and time for the changes to take effect.
3
Confirm schedule
The Console shows the scheduled deployment. You can cancel or modify the schedule before it executes.
Scheduled changes are applied automatically at the specified time. No manual action is required once scheduled.
Archiving products
When a product is discontinued or no longer offered:1
Open the product
Navigate to the product you want to archive.
2
Set effective dates
Update the Effective To date to indicate when the product is no longer available for new applications.
3
Archive the product
Select Archive to remove the product from active listings. Archived products remain in the system for historical reference.
Best practices
Test in Staging first
Always deploy and verify products in Staging before publishing to Production.
Use descriptive IDs
Choose product IDs that are meaningful and consistent across your organisation.
Document changes
Add notes when editing products to maintain a clear audit trail.
Review before publishing
Use the diff view to confirm changes before publishing to Production.
Validation rules
Product Portal validates your data against the regulated specification. Common validation errors include:| Error | Cause | Solution |
|---|---|---|
| Missing required field | A mandatory field is empty | Complete all required fields |
| Invalid enum value | Value not in allowed list | Select from the dropdown options |
| Duplicate product ID | Product ID already exists | Choose a unique product ID |
| Invalid URI format | URL is malformed | Ensure URLs start with https:// |
| Conditional field required | A dependent field is missing | See the field’s conditional rules |