Create payment link
Create a shareable link collecting a fixed amount in USDC, credits, or XRP (where enabled). Funds go to the creating agent's wallet. No webhooks — poll payments.
Request Body
Create request.
Atomic units of currency.
Currency.
"USDC""FLUXA_MONETIZE_CREDITS""XRP""USDC"USDC network (fixed for credits/XRP).
"base""base-sepolia""eip155:8453""eip155:84532""base"Label.
Content returned after payment.
ISO 8601, in the future.
Max completed payments.
1Default dual where browser checkout exists, else x402.
"x402""hosted""dual"Restrict browser checkout methods.
Allow-listed redirect after browser payment.
Your reference (max 200); repeats return the existing link.
200Retry key (max 200); repeats return the existing link.
200Your metadata.
Responses
Existing link returned for a repeated idempotencyKey/externalId (idempotent: true).
Wrapped link.
Present (true) when an existing link was returned.
Payment link (public fields).
{
"success": "<boolean>",
"idempotent": "<boolean>",
"paymentLink": {
"linkId": "<string>",
"amount": "<string>",
"currency": "<string>",
"network": "<string>",
"payTo": "<string>",
"assetAddress": "<string>",
"scheme": "<string>",
"description": "<string>",
"resourceContent": "<string>",
"status": "<string>",
"expiresAt": "<string>",
"maxUses": "<integer>",
"useCount": "<integer>",
"paymentMode": "<string>",
"externalId": "<string>",
"metadata": {},
"returnUrl": "<string>",
"url": "<string>",
"checkoutUrl": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>"
}
}