This project is NOT officially associated with, endorsed by, or supported by Bizappay.

• 🏢 Bizappay is a trademark of its respective owners
• 🔧 This is an independent, community-developed integration
• 📋 Users must comply with Bizappay's Terms of Service
• 🚫 The author assumes no responsibility for API changes or service interruptions
• 💼 For official support, contact Bizappay directly

Use at your own risk and responsibility.

🚀 Transform Your Payment Automation with Bizappay Integration

Streamline your business operations with this powerful n8n node for Bizappay API integration. Experience seamless payment processing with Malaysia's most comprehensive e-wallet solution that supports all major payment methods through a single integration.

✨ All-in-One Payment Solution: Access every major Malaysian e-wallet (GrabPay, Touch 'n Go, Boost, ShopeePay, and more) with just one Bizappay account registration

🎯 Business-Ready Features:

• Intelligent Auto-Correction: Smart input validation and formatting
• Enterprise Authentication: Secure token management with advanced caching
• Comprehensive Bill Management: Create and manage payment bills effortlessly
• Category Organization: Streamlined payment category management
• Robust Error Handling: Professional-grade error management with automatic retry logic
• Performance Optimized: Lightning-fast processing with intelligent caching

💼 Perfect for Malaysian Businesses: Whether you're a startup or enterprise, Bizappay provides the payment infrastructure you need to succeed in Malaysia's digital economy.

• Installation
• Configuration
• Supported Operations
• Auto-Correction Features
• Usage Examples
• Error Handling
• API Reference
• Troubleshooting
• Contributing
• License

Step 1: Install the Node

Choose your preferred installation method:

1. Open your n8n instance
2. Navigate to Settings > Community Nodes
3. Click Install a community node
4. Enter: n8n-nodes-bizappay
5. Click Install

npm install n8n-nodes-bizappay

Add to your Dockerfile:

RUN npm install -g n8n-nodes-bizappay

# Clone repository
git clone https://github.com/nmhafiz/n8n-nodes-bizappay.git
cd n8n-nodes-bizappay

# Install dependencies
npm install

# Build project
npm run build

# Link to n8n
npm link
cd ~/.n8n/nodes
npm link n8n-nodes-bizappay

💡 Need Professional Setup? For complex integrations or custom automation workflows, Sahabat Xpert offers expert implementation services with free consultation for Malaysian businesses.

Step 2: Get Your Bizappay Account

🎯 Ready to revolutionize your payment processing?

1. Sign up for Bizappay: Get started here and unlock access to all major Malaysian e-wallets
2. Access your dashboard: Login to your professional Bizappay portal
3. Get your credentials: Navigate to your dashboard and obtain:
   • API Key: Your unique API identifier
   • Secret Key: Your secure authentication key
   • Collection ID: Your payment collection identifier

Step 3: Configure n8n Integration

1. In n8n, add Bizappay API credentials
2. Enter your authentication details:
   • API Key: Your API key from Bizappay dashboard
3. Click Save

🎉 You're ready to automate payments like a pro!

Generate sophisticated payment bills with intelligent auto-correction and validation.

Essential Parameters:

• Product Name: Professional product description (minimum 5 characters)
• Amount: Payment amount with automatic formatting (RM)
• Customer Name: Customer name with smart formatting (minimum 5 characters)
• Customer Email: Email with validation and correction
• Customer Phone: Customer phone number

Advanced Options:

• Web Return URL: Custom redirect URL for seamless user experience
• Reference 1: Primary reference for tracking
• Reference 2: Secondary reference for detailed categorization

✨ Smart Features:

• Automatic currency formatting
• Data validation and sanitization
• Email validation and correction
• Input sanitization and optimization

Retrieve comprehensive bill details and payment status with advanced filtering capabilities.

Essential Parameters:

• Bill Code: Unique bill identifier (e.g., OiU6DTopBL1)
• Payment Status: Smart dropdown filter with auto-fill
  • Success (1) - Default selection
  • Pending (2)
  • Failed (3)
  • No Action/Not Paid (4)

Professional Features:

• Real-time bill status tracking
• Payment verification and confirmation
• Transaction history retrieval
• Business intelligence data
• Automated status monitoring

✨ Smart Capabilities:

• Intelligent bill code validation
• Auto-filled payment status (Success by default)
• Comprehensive transaction details
• Business-ready data formatting

Access comprehensive payment categories for organized transaction management.

Professional Output:

• Structured category array with ID and name
• Business metadata and status information
• Ready for dropdown integration
• Optimized for business workflows

Experience the power of AI-driven input optimization - The advanced auto-correction system ensures your data is always perfectly formatted for Malaysian business standards.

Enterprise-Grade Email Processing:

// Professional email optimization:
"user@domain"      → "[email protected]"     // Smart domain completion
"[email protected]"  → "[email protected]"     // Professional lowercase formatting
"user @domain.com" → "[email protected]"     // Intelligent space removal
""                 → "[email protected]" // Business-ready auto-fill

• 🔍 Format Verification: Comprehensive email format validation
• 🌐 Domain Intelligence: Smart domain existence checking
• 🔧 Auto-Correction: Fixes common typing errors automatically

Professional Name Formatting:

// Business-standard name formatting:
"john"             → "John Doe"           // Professional surname addition
"  John Doe  "     → "John Doe"           // Space optimization
""                 → "Customer Name"      // Business-ready default

• ✂️ Space Optimization: Removes excessive whitespace
• 📝 Proper Capitalization: Professional name formatting
• 📏 Length Validation: Ensures minimum 5-character requirement

Financial Data Optimization:

// Currency formatting excellence:
"10.5"             → "10.50"             // Precise decimal formatting
"abc"              → "10.00"             // Intelligent default handling
"0"                → "10.00"             // Minimum amount enforcement

• 💱 Currency Symbol Handling: Intelligent removal of currency symbols
• 📊 Decimal Precision: Automatic formatting to 2 decimal places
• ✅ Value Correction: Converts negative values to positive amounts

Professional Product Naming:

// Business-ready product descriptions:
"Tea"              → "Tea - Payment Bill" // Professional suffix addition
"Very long product name that exceeds the maximum length limit"
                   → "Very long product name that exceeds the maximum length li" // Smart truncation
""                 → "Payment Bill"       // Business-standard default

• 📝 Length Optimization: Smart truncation for long descriptions
• 🏷️ Professional Suffixes: Automatic business-appropriate additions
• ✨ Default Handling: Intelligent fallback for empty inputs

Transforming Malaysian businesses with intelligent automation solutions:

🎯 E-commerce Integration: Automated order-to-payment workflows connecting online stores with Bizappay, including inventory management and courier integration for seamless customer experience.

📊 CRM Automation: Complete sales funnel automation from lead capture to payment processing, with automated follow-ups and customer relationship management.

🚀 Multi-Platform Solutions: Integrated booking systems with payment processing, automated invoicing, and real-time business intelligence dashboards.

Need similar automation for your business? Contact Sahabat Xpert for a free consultation.

Create sophisticated payment bills with enterprise-grade automation:

{
  "nodes": [
    {
      "name": "Professional Bill Creation",
      "type": "n8n-nodes-bizappay.bizappay",
      "parameters": {
        "operation": "createBill",
        "description": "Premium Product Package A",
        "amount": "299.00",
        "customerName": "Ahmad Rahman",
        "customerEmail": "[email protected]",
        "customerPhone": "012-345-6789",
        "webreturnUrl": "https://yourbusiness.com/payment-success"
      }
    }
  ]
}

Retrieve comprehensive bill details and payment status with real-time monitoring:

{
  "nodes": [
    {
      "name": "Bill Status Intelligence",
      "type": "n8n-nodes-bizappay.bizappay",
      "parameters": {
        "operation": "getBillInfo",
        "billCode": "OiU6DTopBL1",
        "paymentStatus": "1"
      }
    }
  ]
}

Professional Response Structure:

// Comprehensive bill information output:
{
  "billCode": "OiU6DTopBL1",
  "status": "Success",
  "amount": "RM 299.00",
  "customerName": "Ahmad Rahman",
  "customerEmail": "[email protected]",
  "paymentDate": "2024-01-15T10:30:00Z",
  "paymentMethod": "Touch 'n Go eWallet",
  "transactionId": "TXN123456789",
  "businessMetadata": {
    "reference1": "INV-2024-001",
    "reference2": "DEPT-SALES"
  }
}

Retrieve and organize payment categories for streamlined operations:

{
  "nodes": [
    {
      "name": "Category Intelligence",
      "type": "n8n-nodes-bizappay.bizappay",
      "parameters": {
        "operation": "getCategories"
      }
    }
  ]
}

Experience intelligent data optimization in action:

{
  "nodes": [
    {
      "name": "Smart Bill with Auto-Optimization",
      "type": "n8n-nodes-bizappay.bizappay",
      "parameters": {
        "operation": "createBill",
        "description": "Tea",                    // ✨ Becomes "Tea - Payment Bill"
        "amount": "10.5",                      // ✨ Becomes "10.50"
        "customerName": "john",                 // ✨ Becomes "John Doe"
        "customerEmail": "USER@DOMAIN",         // ✨ Becomes "[email protected]"
        "customerPhone": "012-345-6789"         // ✨ Becomes "+60123456789"
      }
    }
  ]
}

🎯 See the magic happen: Input messy data, get professional results automatically!

Professional error management with intelligent recovery mechanisms

{
  "error": "Invalid authentication",
  "code": 401,
  "message": "API credentials verification failed",
  "solution": "Verify your API key in Bizappay dashboard"
}

{
  "error": "Validation failed",
  "code": 400,
  "details": {
    "amount": "Amount must be greater than 0",
    "customerEmail": "Invalid email format detected"
  },
  "autoCorrection": "Applied intelligent fixes where possible"
}

{
  "error": "Network timeout",
  "code": 500,
  "message": "Connection to Bizappay API failed",
  "retryInfo": "Automatic retry in progress"
}

Advanced resilience with smart recovery:

• 🔢 Max retries: 3 attempts with exponential backoff
• ⏱️ Backoff strategy: Progressive delays (1s → 2s → 4s)
• 🎯 Smart conditions: Network errors, 5xx status codes, rate limits
• 🧠 Adaptive logic: Learns from failure patterns

Secure token-based authentication with automatic management:

POST /api/v3/token
Content-Type: application/x-www-form-urlencoded

apiKey=your_bizappay_api_key

Response:

{
  "status": "ok",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "ttl": 3600
}

POST /api/v3/bill/create
Authentication: {token}
Content-Type: application/x-www-form-urlencoded

apiKey=your_api_key&
description=Premium Product Package&
amount=299.00&
customerName=Ahmad Rahman&
[email protected]&
customerPhone=+60123456789&
webreturnUrl=https://yourbusiness.com/success

POST /api/v3/bill/info
Authentication: {token}
Content-Type: application/x-www-form-urlencoded

apiKey=your_api_key&
search_str=OiU6DTopBL1&
payment_status=1

Response Structure:

{
  "success": true,
  "data": {
    "billCode": "OiU6DTopBL1",
    "status": "Success",
    "amount": "299.00",
    "customerName": "Ahmad Rahman",
    "customerEmail": "[email protected]",
    "paymentDate": "2024-01-15T10:30:00Z",
    "paymentMethod": "Touch 'n Go eWallet"
  }
}

POST /api/v3/category
Authentication: {token}
Content-Type: application/x-www-form-urlencoded

apiKey=your_api_key

🔍 Symptoms:

• "Invalid authentication" errors
• Token validation failures
• API access denied

✅ Professional Solutions:

• Verify API key in your Bizappay Dashboard
• Ensure API key has proper permissions
• Node automatically handles token refresh
• Check network connectivity to Bizappay servers

🔍 Symptoms:

• "Validation failed" messages
• Field format errors
• Missing required data

✅ Smart Solutions:

• Leverage built-in auto-correction features
• Review input data format requirements
• Ensure all mandatory fields are populated
• Use intelligent defaults for missing data

For debugging, enable verbose logging:

// In workflow settings
{
  "settings": {
    "executionOrder": "v1",
    "saveManualExecutions": true,
    "callerPolicy": "workflowsFromSameOwner",
    "errorWorkflow": "error-handler-workflow"
  }
}

# Execute complete test suite
npm test

# Target specific functionality
npm test -- --grep "validation"

# Generate detailed coverage reports
npm run test:coverage

# Production API integration tests
npm run test:integration

# Phone number processing validation
node test-validation.js

# AI auto-correction system testing
node test-auto-correction.js

# Real-world API scenario testing
node test-real-api.js

# Fork and clone the repository
git clone https://github.com/nmhafiz/n8n-nodes-bizappay.git
cd n8n-nodes-bizappay

# Install enterprise dependencies
npm install

# Launch development environment
npm run dev

# Run quality checks
npm run lint && npm test

• 🔷 TypeScript Excellence: 100% TypeScript implementation
• ⚡ ESLint Compliance: Strict adherence to coding standards
• ✨ Prettier Formatting: Automated code beautification
• 🧪 Test Coverage: Mandatory testing for all new features
• 📚 Documentation: Comprehensive inline documentation
• 🔒 Security First: Security-focused development practices

1. 🍴 Fork the repository to your account
2. 🌿 Create feature branch (git checkout -b feature/revolutionary-enhancement)
3. 💻 Develop with excellence and test thoroughly
4. 📝 Commit with descriptive messages (git commit -m 'feat: Add revolutionary enhancement')
5. 🚀 Push to your branch (git push origin feature/revolutionary-enhancement)
6. 🎉 Submit a comprehensive Pull Request

Your contributions matter! Every enhancement helps Malaysian businesses automate their payment processes more effectively.

Need specialized n8n nodes or custom integrations? Sahabat Xpert offers professional development services:

• 🔧 Custom Node Development: Tailored n8n nodes for specific business requirements
• 🌐 API Integration Services: Connect any Malaysian service with n8n workflows
• 🚀 Enterprise Automation: Large-scale workflow automation for corporations
• 📊 Business Intelligence: Custom dashboards and reporting solutions
• 🎯 Training & Consultation: n8n expertise transfer to your development team

This project is licensed under the MIT License - see the LICENSE file for details.

• 🐛 Issues & Bugs: GitHub Issues
• 💬 Community Discussions: GitHub Discussions
• 📧 Direct Support: [email protected]
• 📖 Complete Documentation: API Documentation
• 🌐 n8n Community: n8n Community Forum
• 🏆 Professional Implementation: Sahabat Xpert - Expert consultation and custom development services

Ready to revolutionize your payment processing?

🎯 Get Your Bizappay Account: Sign up here and unlock access to all major Malaysian e-wallets instantly!

💼 Need Professional Implementation?

Partner with the experts: Sahabat Xpert - Your trusted digital transformation partner specializing in comprehensive automation solutions and Bizappay integrations.

✨ Why choose Sahabat Xpert?

• 🏆 Expert n8n Workflow Development: Custom automation solutions tailored to your business
• 🔧 Complete Bizappay Integration Setup: End-to-end payment automation implementation
• 🚀 Sales Process Automation: From sales pages to booking systems with courier integration
• 📊 Business Intelligence Integration: Connect with CRM, e-commerce, and inventory systems
• 💬 Ongoing Technical Support: Dedicated Malaysian business expertise and support
• 🌐 Comprehensive Digital Solutions: Professional website development and business automation

🎯 Specialized Services:

• Custom n8n node development and optimization
• Multi-platform payment gateway integrations
• Automated workflow design for Malaysian businesses
• E-commerce automation with local courier services
• Real-time business intelligence dashboards

🇲🇾 Proudly built for the Malaysian n8n community with ❤️

Empowering businesses across Malaysia with seamless payment automation

🤝 Developed in partnership with Sahabat Xpert - Your trusted automation specialists for comprehensive digital transformation solutions.