This project implements an AI-powered payment service agent that integrates Ant International's Antom payment MCP. The agent is designed to ensure secure and smooth handling of payemnts and refunds through AI interactions.

Ant International's Antom payment MCP wraps Ant International's Antom payment APIs into standardized MCP tools, allowing AI assistants to securely process payment-related operations during conversations. With this MCP server, you can create payment sessions, query transaction status, handle refunds, and more directly through AI interactions.

The Antom Payment Agent aims to provide customers with a convenient and seamless dialogue-based payment process. it enhances the overall shopping and payment experience by flexibly organizing the payment flow according to consumer's intent using Ant International's Antom payment MCP, like initiating order checkout and cancel payment.

• Create Payment Session (create_payment_session): Generate payment sessions for client-side SDK integration
• Query Payment Details (query_payment_detail): Retrieve transaction status and information for submitted payment requests
• Cancel Payment (cancel_payment): Cancel payments when results are not returned within expected timeframes

• Create Refund (create_refund): Initiate full or partial refunds against successful payments
• Query Refund Details (query_refund_detail): Check refund status for previously submitted refund requests

1. Prerequisites

Before using the Antom Payment Agent, ensure you have:

• Python 3.11 or higher
• uv (recommended package manager) or pip
• Valid Antom Merchant Account with:
  • Merchant Client ID (CLIENT_ID)
  • Merchant RSA Private Key (MERCHANT_PRIVATE_KEY)
  • Alipay RSA Public Key (ALIPAY_PUBLIC_KEY)
  • Payment Redirect Return URL (PAYMENT_REDIRECT_URL)
  • Payment Notification Callback URL (PAYMENT_NOTIFY_URL)

2. Installation

# Clone this repository.
git clone https://github.com/google/adk-samples.git
cd adk-samples/python/agents/antom-payment
# Install the package and dependencies.
pip install poetry
poetry install

or
uv venv 
uv sync

3. Configuration

You may set the following environment variables in your shell, or in a python/agents/antom-payment/antom-payemnt-agent/.env file instead.

• Set up Google Cloud credentials.

  GOOGLE_GENAI_USE_VERTEXAI GOOGLE_API_KEY

• your Antom config.

  GATEWAY_URL CLIENT_ID MERCHANT_PRIVATE_KEY ALIPAY_PUBLIC_KEY PAYMENT_REDIRECT_URL PAYMENT_NOTIFY_URL

Using adk

ADK provides convenient ways to bring up agents locally and interact with them. You may talk to the agent using:

poetry run adk web
or
uv run adk web

Try the following prompts:

After running the agent, try the following example prompt

[user]
Create a payment link for an order called "Cream Puff" for $100 and think of a sentence describing Cream Puff.

[agent]
Sure! Here's a payment link for an order called "Cream Puff" for $100:

🔗 Payment Link:
https://open-sea-global.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=https%3A%2F%2Fglobal.alipay.com%2F281002040096G2MGzTTyy0bKXR6HrRDv4Icb

And here's a sentence describing the Cream Puff:

"Indulge in our heavenly Cream Puff — a delicate, golden shell filled with silky vanilla custard and a hint of caramel, perfect for any sweet craving."

Let me know if you want help generating a real payment link using a specific service!