> For the complete documentation index, see [llms.txt](https://pingpay.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pingpay.gitbook.io/docs/pingpay-cli/payment-links.md).

# Payment Links

Payment links are shareable URLs that let anyone pay you. They can be open-amount (payer chooses how much) or fixed-amount.

### Create a payment link

#### Open amount (tip jar, donations)

```bash
ping-cli link create \
  --name "Tip Jar" \
  --recipient-address 0xYourWallet \
  --asset-symbol USDC \
  --asset-chain base
```

#### Fixed amount (invoices, tickets)

```bash
ping-cli link create \
  --name "Conference Ticket" \
  --recipient-address 0xYourWallet \
  --asset-symbol USDC \
  --asset-chain base \
  --amount-type fixed \
  --fixed-amount 50000000
```

**Output:**

```json
{
  "link": {
    "id": "pl_abc123",
    "url": "https://app.pingpay.io/link/pl_abc123",
    "name": "Conference Ticket",
    "recipientAddress": "0xYourWallet",
    "assetSymbol": "USDC",
    "assetChain": "base",
    "amountType": "fixed",
    "fixedAmount": "50000000",
    "active": true,
    "createdAt": "2025-06-01T12:00:00.000Z"
  }
}
```

Share the `url` with anyone - they can pay via browser or CLI.

#### Flags

| Flag                  | Required | Description                                                     |
| --------------------- | -------- | --------------------------------------------------------------- |
| `--name`              | Yes      | Link name (1-100 characters)                                    |
| `--recipient-address` | Yes      | Wallet address to receive funds                                 |
| `--asset-symbol`      | Yes      | Token symbol (`USDC`, `USDT`, etc.)                             |
| `--asset-chain`       | Yes      | Blockchain (`base`, `near`, `eth`, etc.)                        |
| `--amount-type`       | No       | `open` (default) or `fixed`                                     |
| `--fixed-amount`      | No       | Amount in smallest units (required if `amount-type` is `fixed`) |
| `--description`       | No       | Description (max 500 characters)                                |

### Get a payment link

```bash
ping-cli link get pl_abc123
```

**Output:**

```json
{
  "link": {
    "id": "pl_abc123",
    "url": "https://app.pingpay.io/link/pl_abc123",
    "name": "Conference Ticket",
    "amountType": "fixed",
    "fixedAmount": "50000000",
    "active": true
  }
}
```

### List payment links

```bash
# List all links
ping-cli link list

# Filter active links only
ping-cli link list --active true

# Paginate
ping-cli link list --limit 10 --offset 0
```

#### Flags

| Flag       | Default | Description                                 |
| ---------- | ------- | ------------------------------------------- |
| `--limit`  | `50`    | Max results (1-100)                         |
| `--offset` | `0`     | Pagination offset                           |
| `--active` | —       | Filter by active status (`true` or `false`) |

### Delete a payment link

```bash
ping-cli link delete pl_abc123
```

**Output:**

```json
{
  "success": true
}
```

The link URL will stop working immediately after deletion.

***

### Example: Agent creates a payment link and shares it

```bash
# Create a fixed-price link
LINK_URL=$(ping-cli link create \
  --name "API Access - Pro Plan" \
  --recipient-address 0xMerchant \
  --asset-symbol USDC \
  --asset-chain base \
  --amount-type fixed \
  --fixed-amount 25000000 \
  --description "Monthly Pro Plan subscription" \
  | jq -r '.link.url')

echo "Pay here: $LINK_URL"
```