Business Credit Monitoring (BCM) ScoreCard - Implementation Guide

This guide provides comprehensive instructions for integrating Tento's Business Credit Monitoring Dashboard into your website or application. While Tento offers multiple embeddable products, this guide focuses specifically on the BCM ScoreCard implementation.

Requirements

Prerequisites

Before beginning implementation, ensure you have:

• Tento Partner Account with Business Credit Monitoring access
  • Apply at https://apply.tento.co/partners
  • partnerId - Your partner API key
  • x-api-key - Your private API key for all requests
• Target Platform - Website or application for dashboard embedding
• Technical Knowledge - Basic understanding of your platform's integration capabilities
• BCM Customers with retrievable data

Technical Requirements

• JavaScript integration capability
• HTTPS-enabled website (required for secure data transmission)
• Modern web browser support (Chrome, Firefox, Safari, Edge)

Implementation Steps

Step 1: Basic Setup

1. Add Tento Script - Include the Tento JavaScript library in your website
2. Configure Credentials - Set up your Tento credentials using your partnerId

Step 2: BCM ScoreCard Installation

1. Add ScoreCard Code - Implement the BCM ScoreCard code in your desired location
2. Initial Testing - Use hardcoded values as a proof of concept
3. Verification - Confirm the ScoreCard renders correctly on your dashboard

Step 3: Integrate Real BCM Data

Prerequisites: You must have already submitted businesses to receive BCM scores, or established a direct information agreement with Tento.

1. Identify Business ID

   • Store Tento-specific IDs in your system for API calls, OR
   • Use the onBusinessIdentify method with your canonical IDs to retrieve the Tento Business ID

2. Set Up Backend API Request

   • For most recent score: bcm/score/{tentoBusinessId}
   • For comprehensive historical data: /bcm/dashboard/{tentoBusinessId}

3. Pass Data to Frontend - Send the returned data object to the appendBcmScoreCard component

4. Verification - Confirm the ScoreCard displays real user data correctly

Step 4: Customization (Work in Progress)

Customize the dashboard appearance to match your brand (or leave the Tento default color scheme):

Step 5: Testing & Launch

1. Cross-Platform Testing - Verify functionality across different browsers and devices
2. Data Validation - Confirm user flows and data accuracy
3. Compliance Review - Conduct security and privacy compliance checks
4. Production Launch - Deploy to your users

Official Documentation References

Setup Guides

• No-Code Installation: WordPress & WooCommerce Plugin Guide
• Basic Integration: Tento Embedded Experience Overview
• BCM Specific Setup: Business Credit Monitoring Widget Setup

Code Examples

• HTML & JavaScript: HTML & JavaScript Example
• React & TypeScript: React & TypeScript Example
• PHP/WooCommerce: WooCommerce Setup Guide

Additional Resources

• Main Documentation: Tento Docs Home
• API Reference: Available in the main documentation
• Support: Contact Tento support for technical assistance

Key Considerations

User Experience

• Place the dashboard in an easily accessible location
• Ensure the interface is intuitive for business users
• Provide clear instructions for first-time users

Data Security

• All data transmission is encrypted via HTTPS
• User data is handled according to Tento's privacy policy
• Ensure compliance with local data protection regulations

Performance

• The dashboard loads asynchronously to avoid blocking your site
• Optimize for mobile devices and slower connections
• Monitor dashboard performance after implementation

Support & Troubleshooting

For technical issues, implementation questions, or feature requests:

• Check the official Tento documentation
• Contact Tento support directly
• Review the troubleshooting section in the main documentation

Note: This guide provides a high-level overview of BCM Dashboard implementation. For detailed technical instructions, code samples, and advanced configuration options, always refer to the official Tento documentation linked above.