canonical: https://jentic.com/apis/ghostwareos.com/ghostwareos

# Ghostwareos GhostPay API

The GhostPay API creates crypto payment links, initiates payments against them, and runs cross-chain sends and swaps. A merchant creates a payment link, shares it, and then looks up links by wallet address or by link id to track them. Payments are initiated against a link, and a separate operation initiates a cross-chain send or swap so funds can move between networks.

## For AI agents

Create crypto payment links, initiate payments against them, look up links by wallet or id, and start cross-chain sends and swaps through the GhostPay API.

## Scope

Does not host wallets, provide market pricing, or handle fiat card processing. Use for crypto payment links, payments, and cross-chain sends only.

## Capabilities

- Create a crypto payment link for a merchant
- Look up payment links by wallet address
- Retrieve the details of a specific payment link by id
- Initiate a payment against a payment link
- Initiate a cross-chain send or swap between networks

## Use cases

### Agent-Driven Crypto Checkout

An AI agent connected through Jentic generates a crypto payment link for a customer, shares it, and later retrieves the link by id to confirm its details. Because link creation and lookup are single parameterised calls, the agent produces a shareable checkout without building a wallet integration itself.

Example prompt: Create a payment link for a fixed amount, then retrieve it by link id to confirm its status

### Wallet-Scoped Link Tracking

A merchant dashboard tracks outstanding payment links for a given wallet. GhostPay returns the links associated with a wallet address, so an agent reconciles which links belong to which wallet without maintaining its own index.

Example prompt: Fetch all payment links for a wallet address and report which ones have been paid

### Cross-Chain Settlement

An agent settling received funds initiates a cross-chain send or swap to move balances onto the target network. GhostPay exposes a dedicated send/swap operation, so the agent moves funds across chains as a single call rather than orchestrating a bridge manually.

Example prompt: Initiate a cross-chain send to move a settled balance to the target network and record the result

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/links` | Create a payment link |
| GET | `/links/{linkId}` | Get payment link details |
| GET | `/links/wallets/{wallet}` | Get payment links by wallet address |
| POST | `/payments/initiate` | Initiate a payment |
| POST | `/sends/initiate` | Initiate a cross-chain send or swap |

## Key resources

- **Payment links** — Create payment links, retrieve a link by id, and list links by wallet address
- **Payments** — Initiate a payment against a payment link
- **Sends** — Initiate a cross-chain send or swap between networks

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 71 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 75 / 100
  - AI-Readiness & Agent Experience: 50 / 100
  - Agent Usability: 94 / 100
  - Security: 68 / 100
  - AI Discoverability: 68 / 100
- **View full report:** https://jentic.com/apis/ghostwareos.com/ghostwareos/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring GhostPay by hand means handling its bearer API key, tracking the JWT returned by the payment-initiate flow, and coding the cross-chain send call yourself. Through Jentic you install once, import GhostPay from the API Directory, store the key once, and your agent calls the link, payment, and send operations.
- **Permission scoping:** GhostPay carries link-creation and read operations alongside operations that initiate payments and cross-chain sends. You choose the operations your agent may call, so a rule can keep it to creating and reading payment links and leave payment or send initiation out unless you add them.
- **Credential handling:** Your GhostPay API key is held by your own Jentic One instance, encrypted, and injected into the request as a bearer token at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a crypto payment link' or 'initiate a cross-chain send', and Jentic returns the matching GhostPay operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **NOWPayments API** — NOWPayments is a crypto payment gateway for invoices and payments, versus GhostPay's payment links plus cross-chain sends.
- **Tatum API** — Tatum provides blockchain wallet and network infrastructure that pairs with GhostPay's cross-chain sends.
- **Coinbase API** — Coinbase exposes account, wallet, and market data that complements GhostPay's payment-link flow.

## FAQ

### What authentication does the GhostPay API use?

The API uses bearer authentication, sending an API key in the format `gp_live_...` as a bearer token, per its OpenAPI spec. The spec also declares a JWT bearer scheme for tokens returned by the payment-initiate flow. Through Jentic the key is held by your own Jentic One instance and attached to each request at execution time, so it never appears in your agent's prompt or logs.

### Can I create crypto payment links with the GhostPay API?

Yes. The create-link operation returns a payment link you can share, and you retrieve it later by link id or list links by wallet address. Your agent builds a shareable crypto checkout without wiring up a wallet integration directly.

### What are the rate limits for the GhostPay API?

The OpenAPI spec does not specify rate limits. Check the GhostPay documentation at https://api2.ghostwareos.com for current limits before running high-volume payment flows.

### Is there a GhostPay MCP server?

You do not need an MCP server to give your agent the GhostPay API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the payment-link and send operations on demand without loading an extra server's tool definitions into its context.

### Can I limit what my agent is allowed to do with the GhostPay API?

Yes. Write a rule that allows only the operations your agent needs, such as creating and reading payment links, so it cannot initiate payments or cross-chain sends unless you add those operations. You choose what the agent may call, and every call it makes is logged.

### How do I create a payment link through Jentic?

Install the Jentic One command line with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, then add the GhostPay API from the Jentic directory and search by intent such as 'create a crypto payment link'. Jentic returns the matching operation with its input schema so your agent builds a valid request. To run it on your own infrastructure, install Jentic One from its GitHub repo.