> ## Documentation Index > Fetch the complete documentation index at: https://docs.meum.io/llms.txt > Use this file to discover all available pages before exploring further. # Get buyer-facing payment link > Public endpoint for hosted pay-link pages. No API key required. Use the `plpub_` token from the merchant payment link `public_id` field. ## OpenAPI ````yaml /openapi.yaml get /v1/public/payment-links/{public_id} openapi: 3.1.0 info: title: Meum Public Merchant API version: 1.0.0 description: > Public merchant API for programmatic payment management: invoices, transactions, payment links, webhooks, and WooCommerce integration. Authenticate with a store-scoped API key (`sk_live_*`) via Bearer token. Base URL: https://api.meum.io contact: name: Meum Support email: support@meum.io url: https://meum.io servers: - url: https://api.meum.io description: Production security: - bearerAuth: [] tags: - name: Health description: Service health checks - name: Invoices description: Invoice lifecycle - name: Transactions description: On-chain payment transactions - name: Payment Links description: Reusable payment link management - name: Webhooks description: Webhook endpoint and delivery management - name: Integrations description: Third-party platform integrations paths: /v1/public/payment-links/{public_id}: get: tags: - Payment Links summary: Get buyer-facing payment link description: | Public endpoint for hosted pay-link pages. No API key required. Use the `plpub_` token from the merchant payment link `public_id` field. operationId: getPublicPaymentLink parameters: - $ref: '#/components/parameters/PaymentLinkBuyerPublicId' responses: '200': description: Buyer-safe payment link details content: application/json: schema: $ref: '#/components/schemas/PublicPaymentLinkBuyer' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' security: [] components: parameters: PaymentLinkBuyerPublicId: name: public_id in: path required: true description: > Public checkout token from the Pay Link's `public_id` field (starts with `plpub_`). Share this in checkout URLs; do not confuse with the merchant `plink_` ID. schema: type: string pattern: ^plpub_[0-9a-z]{20,32}$ example: plpub_c9a9bb730611077574c828af5af5fed1 schemas: PublicPaymentLinkBuyer: type: object description: Buyer-safe payment link view (no store UUIDs or webhook config). properties: public_id: type: string pattern: ^plpub_[0-9a-z]{20,32}$ description: Public token for this Pay Link (`plpub_...`). Used in checkout URLs. title: type: string description: Display name shown to payers on the checkout page. description: type: - string - 'null' description: Optional longer description or instructions for payers. image_url: type: - string - 'null' format: uri description: Hero or product image URL shown on checkout. amount_mode: $ref: '#/components/schemas/PaymentLinkAmountMode' amount: type: - string - 'null' description: Fixed price when `amount_mode` is `fixed_amount` (decimal string). example: '25.00' currency: type: string description: Currency for all amounts on this link (e.g. `USD`). example: USD min_amount: type: - string - 'null' description: >- Minimum amount payers can enter when `amount_mode` is `customer_defined_amount`. max_amount: type: - string - 'null' description: >- Maximum amount payers can enter when `amount_mode` is `customer_defined_amount`. suggested_amounts: type: array items: type: string description: Preset amount buttons shown on checkout for variable-amount links. usage: type: string enum: - reusable - single_use description: > - `reusable`: multiple payers or repeat payments allowed (subject to link settings) - `single_use`: one successful payment completes the link status: $ref: '#/components/schemas/PaymentLinkStatus' store_name: type: string description: Store display name shown to payers. merchant_name: type: string description: Merchant business name shown to payers. store_logo_url: type: - string - 'null' format: uri deprecated: true description: Omitted on buyer API; use `image_url` when set on the link. PaymentLinkAmountMode: type: string description: > How pricing works on this Pay Link: - `fixed_amount`: you set the price; the customer pays exactly that amount - `customer_defined_amount`: the customer chooses how much to pay (within min/max you set) enum: - fixed_amount - customer_defined_amount PaymentLinkStatus: type: string description: | Whether the Pay Link can accept payments right now: - `active`: open for payments - `inactive`: turned off by you; no new payments - `expired`: past its expiration date - `completed`: single-use link already paid, or usage limit reached enum: - active - inactive - expired - completed PublicApiError: type: object description: Standard error envelope for Public API v1 endpoints. required: - error properties: error: type: object description: Error details for the failed request. required: - type - code - message - request_id properties: type: type: string description: High-level error category used for programmatic handling. enum: - invalid_request - authentication_error - permission_error - not_found - conflict - rate_limit_error - api_error example: not_found code: type: string description: >- Stable machine-readable error code (for example `invoice_not_found`). example: invoice_not_found message: type: string description: Human-readable explanation suitable to show in logs or UI. example: Invoice not found param: type: string description: Request field associated with the error, when applicable. example: url request_id: type: string description: Unique request ID. Include when contacting support. example: req_a1b2c3d4e5f6789012345678 example: error: type: not_found code: invoice_not_found message: Invoice not found request_id: req_a1b2c3d4e5f6789012345678 responses: NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/PublicApiError' RateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/PublicApiError' securitySchemes: bearerAuth: type: http scheme: bearer description: | Store-scoped API key. Prefix with `sk_live_`. Example: `Authorization: Bearer sk_live_EXAMPLE_DO_NOT_USE` ````