A plugin that allows you use alipay tools
Alipay Payment
Author: alipay
Version: 0.0.1
Type: tool
Plugin Description
Overview
Intelligent agent developers can easily integrate into Alipay's payment collection services using the Alipay Payment Plugin . Currently, the plugin provides functionalities such as payment processing, payment inquiry, refund, and refund inquiry for mobile and web applications.
Configuration Guide
- Configure API Key authorization
- Configuration Parameter Details: For information on obtaining Alipay Open Platform AppID, application private key, and Alipay public key, see: Integration Preparation
| Configuration KEY | Description | Optional | Example Value |
|---|---|---|---|
| Alipay Open Platform AppID | The APPID applied for by the merchant on the open platform | Required | 2021xxxxxxxx8009 |
| Application Private Key | The private key set by the merchant on the open platform | Required | MIIEvw.....kO71sA== |
| Alipay Public Key of Application | The Alipay server public key of the merchant on the open platform. This parameter does not need to be exposed to the model and should be set by default in the tool parameters | Required | MIIBIjA......AQAB |
| Synchronous Return URL | The URL to which users will be redirected after payment completion. If configured, Alipay will synchronously redirect back to this address upon payment completion | Optional | https://returnxx.com |
| Asynchronous Notification URL | The URL to which Alipay will send asynchronous notifications after payment completion. If configured, Alipay will send a notification to this address after payment completion. See: Asynchronous Notification Guide | Optional | https://notifyxx.com |
| Third-party Authorization Token for Service Providers | The third-party authorization token used when service providers make delegated API calls. Required only in delegated calling mode | Optional | 202504BBdd...X49 |
Usage Examples
Taking a simple conversational agent as an example, we demonstrate an AI-powered creative assistant integrated with the payment plugin,This assistant can create poems for users, request tips after creation by directly generating a payment link, and perform payment status inquiries, refunds, and refund inquiries.
- Add Alipay Payment Plugin
- Select or enable the required tools as needed
- Generate a payment link and use track tool to see the log
- Query Payment Result
- Refund
- Refund Inquiry
Frequently Asked Questions
| Error Code | Error Description | Cause | Solution |
|---|---|---|---|
| isv.invalid-cloud-app-permission | Invalid open scenario status | The "Payment Mcp Server" switch is not enabled | Log in to the Open Platform Console, go to the app details page, navigate to Restricted Keys under Development Settings, click View, and enable Payment Mcp Server on the restricted key details page. |
| isv.missing-signature-key | Missing signature configuration | The interface signing method for the restricted key has not been set | Log in to the Open Platform Console, go to the app details page, navigate to Restricted Keys under Development Settings, click View, and complete the Interface Signing Method setup on the restricted key details page. |
| isv.invalid-signature | Signature verification failed | The private key configured in the tool call does not match the public key set in the restricted key's interface signing method | 1. Use a new key: Generate a new key pair, log in to the Open Platform Console, go to the app details page, navigate to Restricted Keys under Development Settings, click View, and reconfigure the Interface Signing Method. 2. Use matching keys; refer to Key Matching Guide to find compatible keys. |
| isv.invalid-open-scene-api-permission | Invalid open scenario API permission | Required tools have not been selected | Log in to the Open Platform Console, go to the app details page, navigate to Restricted Keys under Development Settings, click View, and select the tools you intend to use on the restricted key details page. |
Contact Us
We look forward to exploring the infinite possibilities of AI-powered payments with developers and co-creating smarter, more convenient payment experiences. If you encounter any issues during usage or have partnership inquiries, please scan the QR code below with DingTalk to join the Alipay AI Services Collaboration Group. We are always ready to hear your suggestions and requirements.
