Update a payment link
Updates an existing payment link. All fields are optional — only supplied fields are updated.
Path Parameters
Unique identifier of the payment link.
Request Body
Updated name of the person or business receiving the payment.
Updated name of the person making the payment.
Updated email address of the person making the payment.
Updated ID of the account where settled funds will be deposited.
Updated list of blockchain networks to accept payments on.
Possible values: stellar, ethereum, polygon, avalanche, solana
Request Examples
{
"payer_name": "Jane",
"payer_email": "jane@example.com"
}
Responses
| Status | Description |
|---|---|
200 |
Payment link updated successfully. |
400 |
Invalid request parameters. |
404 |
Payment link not found. |
200 response
Unique identifier for the payment link.
Timestamp when the payment link was created (UTC).
Timestamp when the payment link was last updated (UTC).
ID of the customer associated with this payment link.
ID of the tenant that owns this payment link.
Name of the person making the payment.
Email address of the person making the payment.
Name of the person or business receiving the payment.
ID of the account where settled funds will be deposited after a successful payment.
List of blockchain networks the payer can use to complete the payment.
Possible values: stellar, ethereum, polygon, avalanche, solana
A map of blockchain network names to their corresponding wallet addresses for receiving crypto payments.
Shareable URL the payer visits to complete the payment.
Current status of the payment link.
Possible values: active, paused
Error information if the request failed.
{
"data": {
"id": "b905cc64-0f90-4de0-a77c-b183de86b248",
"created_at": "2026-05-07T15:39:02.639185Z",
"updated_at": "2026-05-07T16:00:00.000000Z",
"customer_id": "5e713759-3416-44f5-b797-efd0299aefc1",
"tenant_id": "dfa96ede-fc13-43cf-8328-8b910d1cd1d2",
"payer_name": "Jane",
"payer_email": "jane@example.com",
"payee_name": "Rose",
"settlement_account_id": "b3e3c9fd-77ed-4d14-9c45-68db60d17d3a",
"supported_networks": [
"stellar",
"ethereum"
],
"wallet_addresses": {
"ethereum": "0x119827bef8a3030cd401478fa7b33ac94d3c2572",
"stellar": "GD2WTFAKQJA4BRQRNY3RWGWOFMK52WXZWV3CPCHZV2SJP2QGNBIL6TXQ"
},
"link_url": "https://stables.gravv.xyz/b905cc64-0f90-4de0-a77c-b183de86b248",
"status": "active"
},
"error": null
}
400 response
Human-readable error message.
{
"data": null,
"error": "Invalid request parameters"
}
404 response
Always null for error responses.
Human-readable error message.
{
"data": null,
"error": {
"code": "NOT_FOUND",
"message": "Payment link not found",
"details": {}
}
}
Authorization
- ApiKeyAuth