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.