---
title: "Fetching Payment Links"
method: GET
path: "/links"
tags: ["Payment Links"]
---

# Fetching Payment Links

`GET /links`

Fetches all payment links for a given business<br><br>

## Headers

- `Content-Type` string
- `Authorization` string

## Response `200`

Successful response

- object
  - `data` object[]
    - `name` string — The title of the payment link
    - `description` string — Payment description. This will appear on the payment checkout page.
    - `capacity` integer — The number of times a payment link can be used. The capacity will be ignored when the subscription params exist.
    - `active` boolean
    - `return_url` string, uri — The URL which the customer will be redirected to after a successful payment.
    - `terms_and_conditions_url` string, uri — The URL to the terms and conditions page, if provided, the customer will be required to accept the terms before proceeding to payment.
    - `processing_fee_percentage` number
    - `amount` number
    - `amount_currency` 'AED' | 'USD' | 'EUR' | 'GBP' | 'SAR'
    - `link_type` 'standalone' | 'modal' | 'inline' — Type of link to be created.
    - `enable_tabby` boolean — Enables the ability for customers to buy now and pay later.
    - `enable_message` boolean — Enables the ability for customers to add a message during the checkout process.
    - `enable_tips` boolean — Enables the tips option. This will be displayed on the first screen.
    - `enable_customer_details` boolean — Enables adding customer details such as the name, email, and phone number. This screen will be displayed before the payment details screen.
    - `enable_quantity` boolean — When enabled, customers can specify the number of items they intend to purchase. This quantity will serve as a multiplier for the base amount.
    - `enable_qr_code` boolean — Adds the ability to verify a payment through a QR code.
    - `send_customer_receipt` boolean — Enables the sending of customer receipts.
    - `save_card` 'off' | 'optional' | 'required' — Allows the merchant to enable the option to store card details to be used later on for Merchant Initiated Transactions.
    - `payment_methods` unknown[] — An array of accepted payment methods, card always apart of default option. Example: ['card', 'wallet']
      - unknown
    - `rules` object — Setting the rule for payment link
      - `allowed` object[] — An array of one or more rules
        - `type` 'bins' — name of rules
        - `list` unknown[] — value of bins
          - unknown
        - `decline_message` string — Custom decline message for this rule
    - `subscription` object — to be populated if this payment link is for a subscription. Otherwise, this property can be left out. REQUIRES Premium Business Plan to be enabled.
      - `frequency` 'annually' | 'monthly' | 'weekly' — defines the interval that this subscription will be run on.
      - `frequency_interval` integer — defines how often this subscription will run. This will be based on the frequency property defined above.
      - `end_date` string — the last date this subscription could run on.
      - `payment_quantity` integer — number of times this subscription will occur. If end_date defined, end_date takes precedence.
    - `first_name` string — The first name of customer which will pre-populate in card info step.
    - `last_name` string — The last name of customer which will pre-populate in card info step.
    - `email` string — The email of customer which will pre-populate in card info step.
    - `payouts_share` object
      - `recipient_id` string — The ID of an already added recipient that the transaction amount will be shared with.
      - `percentage_to_recipient` number — The percentage of the transaction amount that will be sent to the recipient.
      - `recipient_pays_fees` boolean — Whether Mamo fees for a given transaction will be passed on to the recipient.
    - `custom_data` object
    - `id` string
    - `title` string
    - `platform` string
    - `prefilled_customer` object
    - `external_id` string
    - `hold_and_charge_later` boolean
    - `internal_note` string
    - `lang` string
    - `expiration_date` string
    - `is_widget` boolean
    - `max_amount` number
    - `processing_fee_amount` number
    - `payment_url` string
  - `pagination_meta` object
    - `page` number
    - `per_page` number
    - `total_pages` number
    - `next_page` number
    - `prev_page` number
    - `from` number
    - `to` number
    - `total_count` number

## Other responses

- `403` — Unauthorised
- `500` — Unexpected error

---

[API](https://skmtc.net/mamopay/apis/payments.md) · [All operations](https://skmtc.net/mamopay/apis/payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mamopay/payments/versions/65bb3871a425/schema)