Dify x402 Integration
Dify is a comprehensive platform for building AI applications through visual workflows and no-code interfaces. It combines the power of LLMs with user-friendly drag-and-drop tools, making AI application development accessible to non-technical users while providing advanced features for developers. The platform's API and webhook system enables straightforward x402 payment integration.
💻 x402 Integration Method
Integration Type: Custom Code
Dify's API and webhook system allows for x402 integration through custom code blocks and external API calls, suitable for both no-code and developer workflows.
Setup Complexity
Maintenance
Documentation
Examples
Installation & Setup
Install the necessary packages to get started with x402 payments in Dify:
# Install the necessary packages pip install dify dify-openai x402-dify
The x402-dify package is a helper library that simplifies wrapping facilitators into Dify-compatible tools, bridging our facilitator ecosystem with your agent framework.
Integration Examples
x402 Payment API Integration
Integrate x402 payments into Dify workflows using custom API calls and webhook responses
# Custom API node configuration in Dify
{
"type": "api",
"method": "POST",
"url": "https://api.xpay.sh/payments",
"headers": {
"Authorization": "Bearer {{api_key}}",
"Content-Type": "application/json"
},
"body": {
"amount": "{{workflow.amount}}",
"recipient": "{{workflow.recipient}}",
"memo": "{{workflow.memo}}"
},
"response_mapping": {
"transaction_id": "{{response.data.id}}",
"status": "{{response.data.status}}"
}
}Prerequisites:
Dify account
x402 API credentials
Basic API knowledge
Choosing Your Facilitator
The X402PaymentTool is generic and works with any facilitator that has a compatible client. Here's how you might initialize different clients based on your specific needs:
For Enterprise (CDP)
from x402_facilitators import CDPClient client = CDPClient(api_key="...")
See the CDP Facilitator Guide for details.
For Zero Fees (Mogami)
from x402_facilitators import MogamiClient client = MogamiClient(wallet_pk="...")
See the Mogami Facilitator Guide for details.
For Developer Experience (thirdweb)
from x402_facilitators import ThirdwebClient client = ThirdwebClient(secret_key="...")
See the thirdweb Facilitator Guide for details.
Custom Setup
# Use any facilitator from our hub
from x402_facilitators import CustomClient
client = CustomClient(config={"..."})Browse all 8 facilitators in our hub.
Quick Info
Category
Low-Code/No-Code
Primary Language
Python
License
Apache-2.0
Latest Version
0.9.0
Community Stats
GitHub Stars
52,000
Weekly Downloads
5,000
Community Size
Large
Payment-Enabled Use Cases
Customer service chatbots
Internal knowledge assistants
Content generation workflows
Data analysis and reporting
Marketing automation
Document processing pipelines
E-commerce assistants
Educational applications
Strengths
User-friendly visual interface
Strong community and rapid growth
Comprehensive feature set
Good documentation and examples
Active development and updates
Both cloud and self-hosted options
Enterprise-ready features
Multi-language support
Limitations
Custom integrations require development
Visual interface can be limiting for complex logic
Relatively new platform
Limited advanced programming features
Dependency on external LLM providers
Learning curve for workflow design
Performance limitations for complex workflows
Enterprise features require payment
Get the Complete Template
Access a complete, runnable repository with working Dify x402 integration examples, configuration templates, and step-by-step setup guides.
View on GitHub: Dify x402 TemplateReady to Build Payment-Enabled Agents?
Get started with our complete Dify x402 integration template. Includes working examples, facilitator configurations, and production-ready code.