Payment Links overview
Use the Payment Links API to create, retrieve, update, disable, and resolve shareable crypto payment links.
Create a payment link or browse the operations in this category.
Configure API-key authentication for your integration.
How it works
Payment links let you collect crypto payments without building checkout UI:
- Create a payment link specifying the networks you accept in
supported_networks. The response includes a shareablelink_urlplus a wallet address for each network. - Share the
link_urlwith 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. - Manage the link's lifecycle — pause or reactivate it, update its details, or delete it permanently.
Endpoints
| Endpoint | Description |
|---|---|
POST /v1/payment-links |
Create a payment link with per-network wallet addresses |
GET /v1/payment-links |
List your payment links, filterable by status |
GET /v1/payment-links/{id} |
Retrieve a single payment link |
PUT /v1/payment-links/{id} |
Update a payment link — only supplied fields change |
DELETE /v1/payment-links/{id} |
Permanently delete a payment link |
PATCH /v1/payment-links/{id}/status |
Set the link to active or paused |
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.
Was this page helpful?