Back to the catalog

airwallex-dev

Build Airwallex payment integrations in your own codebase. Generates the checkout, card-element, onboarding, and subscription-billing code f

Open source Repository Open in the app JSON README (API)

About

Build Airwallex payment integrations in your own codebase. Generates the checkout, card-element, onboarding, and subscription-billing code for an Airwallex integration and wires it into your project: Hosted Payment Page, Drop-in and Split Card elements, connected-account KYC onboarding, and Billing Hosted Checkout for subscriptions and card-saving. Also plans card-on-file merchant-initiated flows for AI providers such as top-ups and auto-recharge.

Details

Kind
Plugins
Topic
Finance & crypto
Publisher
airwallex
Origin
marketplace
Category
ferramentas
Stars
5
Forks
2
Last push
2026-08-24T13:29:10Z
Repository state
ativo
License
Apache-2.0
Added
2026-08-30 01:48:58
Updated
2026-08-30 01:48:58
Origin id
airwallex/airwallex-marketplace/airwallex-dev

README

# Airwallex AI

Agent skills for integrating Airwallex with LLMs and agent frameworks.

## Plugins

| Plugin | Surfaces | Archetype | Description |
| --- | --- | --- | --- |
| [airwallex-agentos](./plugins/airwallex-agentos) | CLI + MCP | Workflow / Reference | Agent skills for Billing, Payouts, Issuing, and Treasury. Works with the `airwallex` CLI or an Airwallex MCP server. |
| [airwallex-dev](./plugins/airwallex-dev) | MCP | Integration | Developer-focused skills that generate production-ready code for Airwallex API integrations. |

### airwallex-agentos - Workflow & Reference Skills

| Skill | Category | Description |
| --- | --- | --- |
| contract-to-billing | Billing | Extract from POs/contracts/quotes → create invoices and/or subscriptions |
| beneficiary-creation | Payouts | Extract bank details from supplier docs → validate per-country → create beneficiaries |
| card-provisioning | Issuing | Create cardholders, issue virtual/physical cards with spend limits, manage spending |
| manage-cashflow | Treasury | Aggregate multi-currency balances, receivables, obligations, FX exposure, indicative rates |
| awx-best-practices | Fallback | Ad-hoc operations, troubleshooting, and domains not covered by a workflow skill above |

### airwallex-dev - Integration Skills

These skills work on the code in your project rather than driving conversations. Five generate integration code; `airwallex-ai-provider-card-mit` produces an implementation plan document instead.

Install with `claude plugin install airwallex-dev@airwallex-marketplace` or `codex plugin add airwallex-dev@airwallex-marketplace`, after adding the marketplace as shown under [Installation](#installation).

| Skill | Category | Description |
| --- | --- | --- |
| airwallex-hpp | Payments | Hosted Payment Page: redirect-based checkout hosted by Airwallex |
| airwallex-dropin | Payments | Drop-in Element: embedded UI supporting multiple payment methods |
| airwallex-split-card | Payments | Split Card Element: separate card number, expiry, and CVC inputs for full UI control |
| airwallex-billing-checkout | Billing | Billing Hosted Checkout for subscriptions, one-off payments, and card-saving (SETUP) |
| airwallex-kyc | Connected Accounts | Connected account KYC onboarding via embedded component or hosted link |
| airwallex-ai-provider-card-mit | Payments | Implementation plan for card-on-file MIT flows used by AI providers (top-ups, auto-recharge, subscriptions) |

### Connectors

Claude Code, Cursor, and Codex installations include the MCP connector automatically. If you install via `npx skills`, you will need to set up a connector separately. See the [Connectors](https://www.airwallex.com/docs/developer-tools/ai/agentos/connectors) page for options:

- **CLI:** `airwallex` CLI installed and authenticated.
- **MCP:** An Airwallex MCP server connected to your AI coding assistant.

## Installation

Pick the method that matches your editor or workflow. The two plugins install separately, so choose whichever you need.

### Claude Code

Add the marketplace, then install either plugin:

```sh
claude plugin marketplace add https://github.com/airwallex/airwallex-marketplace
claude plugin install airwallex-agentos@airwallex-marketplace
claude plugin install airwallex-dev@airwallex-marketplace
```

> **Skill namespacing:** Installed skills are prefixed by the plugin name. To invoke a skill, use the format `/airwallex-agentos:contract-to-billing` or `/airwallex-dev:airwallex-hpp`.

### Cursor

`airwallex-agentos` is listed in the [Cursor Marketplace](https://cursor.com/marketplace). Search for **Airwallex AgentOS** in **Cursor Settings → Plugins** to install it.

`airwallex-dev` is not listed there yet, so add this marketplace by URL instead: in **Cursor Settings → Plugins**, click **Import** under **Team Marketplaces** and paste `https://github.com/airwallex/airwallex-marketplace`, then install `airwallex-dev`.

### Codex

Add the marketplace and install the plugin:

```sh
codex plugin marketplace add https://github.com/airwallex/airwallex-marketplace
codex plugin add airwallex-agentos@airwallex-marketplace
codex plugin add airwallex-dev@airwallex-marketplace
```

You can also browse and install from the Codex plugin directory (`/plugins` in the CLI). The Codex plugins use the same skills and MCP server configuration as the Claude Code and Cursor plugins.

### Grok

Add the marketplace, then install either plugin:

```sh
grok plugin marketplace add https://github.com/airwallex/airwallex-marketplace
grok plugin install airwallex-agentos --trust
grok plugin install airwallex-dev --trust
```

The Grok plugins use the same skills and MCP server configuration as the Claude Code, Cursor, and Codex plugins.

### npx (skills only)

Install the agent skills with a single command:

```sh
npx skills add airwallex/airwallex-marketplace
```

This installs the agent skills only and does **not** configure an Airwallex MCP server connection. If your workflow requires the MCP server, you will need to set it up separately in your client's MCP configuration. See [Connectors](#connectors) above.

---

> **Upgrading from 0.1.x?** Install `airwallex-agentos` to get the renamed plugin. The old `airwallex` entry becomes a tombstone with no skills or MCP servers — uninstalling it is recommended cleanup but not a prerequisite. Update any skill invocations from `/airwallex:…` to `/airwallex-agentos:…`.

After installing, make sure you have at least one of the prerequisite toolchains available (the `airwallex` CLI or an Airwallex MCP server). See [Connectors](#connectors) above.

## Important Notice

> **Beta Feature.** This plugin is provided on an "as-is" basis for use with
> Airwallex APIs (via the `airwallex` CLI or an MCP server). By using this
> plugin, you acknowledge that:
>
> - Actions taken via your Airwallex API keys, whether initiated by you
>   directly or by an AI agent acting on your behalf, are governed by the
>   [Airwallex Terms of Service](https://www.airwallex.com/terms) accepted
>   during account creation and surface authentication (`airwallex auth login`
>   for the CLI, OAuth authorization for the MCP server).
> - You are responsible for safeguarding your API keys and ensuring they are
>   used only in accordance with your intended purpose.
> - This plugin does **not** provide financial, legal, or tax advice. AI agent
>   outputs are probabilistic and should be reviewed by a qualified person
>   before acting on them.
> - This plugin does **not** initiate money-out actions (transfers, FX
>   conversions, or payouts) on your behalf. Where such capabilities exist in
>   the underlying API, the skills are explicitly instructed not to execute
>   them.

## License

Apache-2.0. See [LICENSE](LICENSE).

More