Skip to Content

Connect Alipay to Your AI Agent

Prepare a desktop or mobile payment link with an explicit order number and amount, then check the transaction result.

5 toolsCustom credential

20,000 free app calls every month(paid services billed separately)

Try a Alipay Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillAlipay

Prepare a checkout link

Create a payment URL for a specific merchant order.

/oo Alipay: Generate an Alipay [desktop or mobile] payment link for order [order number], title [title], amount [amount] CNY. Return the URL and order number. Do not report the payment as complete until its status is queried.

Check a payment

Verify the transaction status and recorded amount.

/oo Alipay: Query Alipay order [order number]. Report its transaction status and amount, and compare the amount with the expected [amount] CNY.

Refund a specified amount

Submit an explicitly requested refund and check its result.

/oo Alipay: Refund [amount] CNY for Alipay order [order number] with refund request number [refund number] and reason [reason]. Reuse this number and amount on retries. If the response does not confirm completion, query the refund after at least 10 seconds.

Start Working with Alipay

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Alipay

    Open https://aipay.alipay.com and select One-stop Integration > VibePay > Web Application to obtain the App ID, application private key, and Alipay public key for your environment.

    Connect Alipay→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • Enable the relevant Alipay payment products for your application.
  • Choose production or sandbox and use the matching application credentials.
  • Connection setup validates key format locally. Product permissions are checked when Alipay processes a request.
  • Keep merchant order numbers and refund request numbers stable when retrying the same operation.

Alipay Tools

Connect an Alipay merchant application to generate signed checkout URLs, query payments, and manage full or partial refunds. Buyers complete payments through Alipay.

Desktop and mobile checkout

Generate signed payment URLs for buyers to open.

Payment and refund status

Query payments, request refunds, and check refund outcomes.

5 tools

Create Web Payment

Generate a signed Alipay desktop checkout URL locally. The buyer must open the URL and complete payment; use query_payment to verify the transaction status.

alipay.create_web_payment

Create Mobile Payment

Generate a signed Alipay mobile website checkout URL locally. The buyer must open the URL and complete payment; use query_payment to verify the transaction status.

alipay.create_mobile_payment

Query Payment

Query an Alipay transaction and return its verified business response. Check trade_status and the order amount before treating a payment as complete.

alipay.query_payment

Refund Payment

Request a full or partial Alipay refund. Reuse out_request_no and refund_amount on retries. fund_change=Y confirms success; otherwise use query_refund to check the outcome.

alipay.refund_payment

Query Refund

Query an Alipay refund request. Only refund_status=REFUND_SUCCESS confirms a successful refund. Allow at least 10 seconds after requesting the refund before querying.

alipay.query_refund

Frequently Asked Questions

Does generating a payment link mean the order is paid?

No. The buyer must open the link and complete payment. Query the transaction to check its status and amount.

How do I confirm a refund succeeded?

fund_change=Y confirms refund success. Otherwise, query the refund; refund_status=REFUND_SUCCESS confirms completion. A successful API request alone does not prove the refund completed.

Can I use a sandbox account?

Yes. Select sandbox and supply its App ID and matching keys. Sandbox transactions do not move real funds.