Payment Links

Retrieve a payment link

Same fields as create, plus transactions: every payment (inbound or outbound) recorded against this link, newest first, same row shape as a Transaction but without the computed money breakdown.

get/gateway/payment-links/{id}

Request

  • Base URL: https://api.agentaos.ai/api/v1
  • URL: https://api.agentaos.ai/api/v1/gateway/payment-links/{id}
  • Auth: API key in header x-api-key

Path parameters

idstring uuid required

Payment link UUID.

Response

The payment link, with its transaction history.

idstring uuid required

Payment link UUID.

org_idstring uuid required
user_idstring uuid required
secure_link_idstring required

Public ID used in the checkout URL.

amountnumber required

Currency units.

currencystring required

Settlement currency or token.

descriptionstring nullable required
metadataobject required

Your custom data.

webhook_urlstring nullable required
success_urlstring nullable required
cancel_urlstring nullable required
tax_rate_idstring uuid nullable required
status'active' | 'cancelled' required
payment_countinteger required

Successful payments against this link so far.

supported_networksstring[] required
expires_atstring date-time nullable required
created_atstring date-time required
updated_atstring date-time required
namestring nullable required
image_urlstring nullable required
max_usesinteger nullable required

null means unlimited.

seller_mode'mor' | 'crypto' required

mor (card + bank) or crypto (on-chain). The snake_case column equivalent of the computed sellerMode.

type'one_time' | 'subscription' required
billing_interval'month' | 'year' | 'null' nullable required
environment'test' | 'live' required
checkoutUrlstring required

Full URL to share with buyers. Computed, camelCase, no snake_case equivalent.

sellerMode'mor' | 'crypto' required

Changes

No recorded changes to this operation across all 1 revision of this API.