---
title: "Payment Links overview"
description: "Create and manage shareable crypto payment links."
---

# Payment Links overview

Use the Payment Links API to create, retrieve, update, disable, and resolve shareable crypto payment links.

<CardGroup cols={2}>
  <Card title="Browse payment link endpoints" icon="code" href="/api-reference/payment-links/post-v1-payment-links">
    Create a payment link or browse the operations in this category.
  </Card>
  <Card title="Authentication" icon="key" href="/getting-started/authentication">
    Configure API-key authentication for your integration.
  </Card>
</CardGroup>

## How it works

Payment links let you collect crypto payments without building checkout UI:

1. [Create a payment link](/api-reference/payment-links/post-v1-payment-links) specifying the networks you accept in `supported_networks`. The response includes a shareable `link_url` plus a wallet address for each network.
2. Share the `link_url` with the payer. They open it and complete payment on their preferred network. Your payer-facing page can resolve links without credentials via the [public endpoint](/api-reference/payment-links/get-v1-payment-links-public-id).
3. Manage the link's lifecycle — [pause or reactivate](/api-reference/payment-links/patch-v1-payment-links-id-status) it, [update](/api-reference/payment-links/put-v1-payment-links-id) its details, or [delete](/api-reference/payment-links/delete-v1-payment-links-id) it permanently.

## Endpoints

| Endpoint | Description |
|---|---|
| [`POST /v1/payment-links`](/api-reference/payment-links/post-v1-payment-links) | Create a payment link with per-network wallet addresses |
| [`GET /v1/payment-links`](/api-reference/payment-links/get-v1-payment-links) | List your payment links, filterable by `status` |
| [`GET /v1/payment-links/{id}`](/api-reference/payment-links/get-v1-payment-links-id) | Retrieve a single payment link |
| [`PUT /v1/payment-links/{id}`](/api-reference/payment-links/put-v1-payment-links-id) | Update a payment link — only supplied fields change |
| [`DELETE /v1/payment-links/{id}`](/api-reference/payment-links/delete-v1-payment-links-id) | Permanently delete a payment link |
| [`PATCH /v1/payment-links/{id}/status`](/api-reference/payment-links/patch-v1-payment-links-id-status) | Set the link to `active` or `paused` |
| [`GET /v1/payment-links/public/{id}`](/api-reference/payment-links/get-v1-payment-links-public-id) | Resolve an active link without authentication (payer-facing) |

## Link statuses

| Status | Meaning |
|---|---|
| `active` | Payers can open the link and complete payments |
| `paused` | The link resolves but can't be used to complete payments |

## Authentication

All requests use `https://api.gravv.xyz/v1/` and authenticate with the `Api-Key` header, except the public resolve endpoint, which is unauthenticated and only returns active links.