@mollie/api-client/dist/types/data/paymentLinks/data.d.ts

Official Mollie API client for Node

import { type Amount, type ApiMode, type Links, type PaymentMethod, type Url } from '../global';
import type Model from '../Model';
export interface PaymentLinkData extends Model<'payment-link'> {
    /**
     * The mode used to create this payment link. Mode determines whether a payment link is *real* (live mode) or a *test* payment link.
     *
     * Possible values: `live` `test`
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=mode#response
     */
    mode: ApiMode;
    /**
     * A short description of the payment link. The description is visible in the Dashboard and will be shown on the customer's bank or card statement when possible. This description will eventual been
     * used as payment description.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=description#response
     */
    description: string;
    /**
     * The amount of the payment link, e.g. `{"currency":"EUR", "value":"100.00"}` for a €100.00 payment link.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=amount#response
     */
    amount?: Amount;
    /**
     * The minimum amount of the payment link. This property is only allowed when there is no amount provided. The customer will be prompted to enter a value greater than or equal to the minimum amount.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=minimumAmount#response
     */
    minimumAmount?: Amount;
    /**
     * Whether the payment link is archived. Customers will not be able to complete payments on archived payment links.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=archived#response
     */
    archived: boolean;
    /**
     * The URL your customer will be redirected to after completing the payment process.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=redirectUrl#response
     */
    redirectUrl?: string;
    /**
     * The URL your customer will be redirected to after completing the payment process.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=redirectUrl#response
     */
    webhookUrl?: string;
    /**
     * The identifier referring to the profile this payment link was created on. For example, `pfl_QkEhN94Ba`.
     *
     * Most API credentials are linked to a single profile. In these cases the profileId can be omitted in the creation request. For organization-level credentials such as OAuth access tokens however, the profileId parameter is required.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=profileId#response
     */
    profileId: string;
    /**
     * Indicates whether the payment link is reusable. If this field is set to true, customers can make multiple payments using the same link.
     *
     * If no value is specified, the field defaults to false, allowing only a single payment per link.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=reusable#response
     */
    reusable?: boolean;
    /**
     * The payment link's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=createdAt#response
     */
    createdAt: string;
    /**
     * The date and time the payment link became paid, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=paidAt#response
     */
    paidAt?: string;
    /**
     * The date and time the payment link last status change, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=updatedAt#response
     */
    updatedAt?: string;
    /**
     * The expiry date and time of the payment link, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=expiresAt#response
     */
    expiresAt?: string;
    /**
     * An array of payment methods that are allowed to be used for this payment link. When this parameter is not provided or is an empty array, all enabled payment methods will be available.
     *
     * Possible values: `applepay` `bancomatpay` `bancontact` `banktransfer` `belfius` `blik` `creditcard` `eps` `giftcard` `ideal` `kbc` `mybank` `paybybank` `paypal` `paysafecard` `pointofsale` `przelewy24` `satispay` `trustly` `twint`
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=allowedMethods#response
     */
    allowedMethods?: PaymentMethod[];
    /**
     * With Mollie Connect you can charge fees on payment links that your app is processing on behalf of other Mollie merchants.
     *
     * If you use OAuth to create payment links on a connected merchant's account, you can charge a fee using this applicationFee parameter.
     *
     * @see https://docs.mollie.com/reference/v2/payment-links-api/get-payment-link?path=applicationFee#response
     */
    applicationFee?: {
        /**
         * The fee that you wish to charge.
         */
        amount: Amount;
        /**
         * The description of the application fee. This will appear on settlement reports towards both you and the connected merchant.
         */
        description: string;
    };
    _links: Links & {
        paymentLink: Url;
    };
}