This Integration Guides page provides technical and operational guidance for partners, merchants, and developers integrating with the Senang.io platform (“Senang.io”, “we”, “us”, or “our”).

By accessing these guides and integrating with Senang.io’s systems, you agree to comply with our API Documentation, Sandbox & API Key Request terms, and all applicable policies.

1. Purpose

• 1.1 The purpose of these Integration Guides is to assist approved partners in successfully connecting their systems to Senang.io services.

  
  

• 1.2 These guides outline the technical steps, configuration requirements, and recommended best practices for integration.

  
  

• 1.3 Integration may include (where applicable):
  
  

  • Quotation and pricing retrieval

  • Policy or coverage issuance

  • Payment processing and confirmation

  • Claims submission and tracking

  • Webhook notifications

  • Reporting and reconciliation

2. Integration Methods

• 2.1 Senang.io may support one or more of the following integration methods:
  
  

  • a. REST API integration

  • b. Web-based embedded solutions (iframe or hosted checkout)

  • c. Direct server-to-server integration

  • d. Webhook event notifications

  • e. Batch file processing (if applicable)

• 2.2 The appropriate integration method will depend on your business model, technical capability, and approval level.

3. Pre-Integration Requirements

• 3.1 Before starting integration, you must:
  
  

  • Obtain sandbox access and API credentials

  • Review the API Documentation

  • Define your integration use case

  • Assign a technical contact person
    
    

• 3.2 You may be required to sign a commercial or partnership agreement prior to production deployment.

• 3.3 Ensure your development team understands:
  
  

  • Authentication requirements

  • Data structure formats (e.g., JSON payloads)

  • Security protocols

  • Error handling standards

4. Standard Integration Flow

• 4.1 A typical integration flow may include the following steps:
  
  

  • Step 1 – Authentication
    Authenticate using your issued API credentials.
    
    

  • Step 2 – Product or Quotation Request
    Request available products, pricing, or quotations based on user input.
    
    

  • Step 3 – Customer Data Submission
    Submit required customer information securely.
    
    

  • Step 4 – Transaction or Policy Issuance
    Trigger policy issuance or product activation upon successful validation.
    
    

  • Step 5 – Payment Confirmation
    Confirm successful payment via API response or webhook event.
    
    

  • Step 6 – Status & Reporting
    Retrieve policy status, transaction logs, or reporting data.

• 4.2 The exact flow may vary depending on the product or service integrated.

5. Webhooks & Event Notifications

• 5.1 Senang.io may provide webhook notifications for real-time updates.
  
  

• 5.2 Common webhook events may include:
  
  

  • Payment success or failure

  • Policy issuance confirmation

  • Claim status updates

  • Cancellation notifications

• 5.3 You must:
  
  

  • Provide a secure HTTPS endpoint

  • Validate webhook signatures

  • Handle idempotency to prevent duplicate processing

6. Testing & Validation

• 6.1 All integrations must first be tested in the sandbox environment.

  
  

• 6.2 Testing should include:
  
  

  • Successful transaction flows

  • Error scenarios

  • Rate limit handling

  • Webhook validation

  • Data validation checks

• 6.3 Production access will only be granted upon successful completion of required test cases.

7. Security & Data Protection

• 7.1 You must ensure all API calls are made over secure HTTPS connections.

  
  

• 7.2 Sensitive information must not be logged in plain text.

  
  

• 7.3 API keys and secrets must be securely stored and never exposed in client-side code.

  
  

• 7.4 You must comply with applicable data protection regulations and ensure customer data is processed lawfully.

8. Error Handling & Troubleshooting

• 8.1 Your integration must properly handle standard HTTP response codes.

  
  

• 8.2 Common error categories include:
  
  

  • Authentication errors

  • Validation errors

  • Rate limit exceeded

  • System or server errors

• 8.3 You should implement retry logic where appropriate and avoid excessive automated retries that may trigger rate limits.

9. Go-Live & Production Deployment

• 9.1 Production deployment requires:
  
  

  • Final technical validation

  • Approval from Senang.io

  • Secure handling of production credentials

• 9.2 Production API keys must not be used in development or test environments.
  
  

• 9.3 You are responsible for monitoring your live integration and ensuring system stability.

10. Ongoing Maintenance

• 10.1 You are responsible for maintaining compatibility with API version updates.
  
  

• 10.2 Senang.io may release:

  • API enhancements

  • New endpoints

  • Security updates

  • Deprecation notices

• 10.3 Continued use of the API after updates constitutes acceptance of any changes.

11. Support & Escalation

• 11.1 For integration-related questions, technical issues, or escalation, please contact:
  
  

  Email: customercare@senang.io
  
  

• 11.2 When contacting support, please provide:
  
  

  • Your partner ID

  • API key reference (partial only, do not send full secret)

  • Description of the issue

  • Sample request/response logs (with sensitive data masked)