Mayson Monorepo Documentation
    Preparing search index...

    A payment link is a shareable URL that will take your customers to a hosted payment page. A payment link can be shared and used multiple times.

    When a customer opens a payment link it will open a new checkout session to render the payment page. You can use checkout session events to track payments through payment links.

    Related guide: Payment Links API

    interface PaymentLink {
        id: string;
        object: "payment_link";
        active: boolean;
        after_completion: Stripe.PaymentLink.AfterCompletion;
        allow_promotion_codes: boolean;
        application: string | Application | DeletedApplication;
        application_fee_amount: number;
        application_fee_percent: number;
        automatic_tax: Stripe.PaymentLink.AutomaticTax;
        billing_address_collection: Stripe.PaymentLink.BillingAddressCollection;
        consent_collection: Stripe.PaymentLink.ConsentCollection;
        currency: string;
        custom_fields: Stripe.PaymentLink.CustomField[];
        custom_text: Stripe.PaymentLink.CustomText;
        customer_creation: Stripe.PaymentLink.CustomerCreation;
        inactive_message: string;
        invoice_creation: Stripe.PaymentLink.InvoiceCreation;
        line_items?: ApiList<Stripe.LineItem>;
        livemode: boolean;
        metadata: Metadata;
        name_collection?: Stripe.PaymentLink.NameCollection;
        on_behalf_of: string | Stripe.Account;
        optional_items?: Stripe.PaymentLink.OptionalItem[];
        payment_intent_data: Stripe.PaymentLink.PaymentIntentData;
        payment_method_collection: Stripe.PaymentLink.PaymentMethodCollection;
        payment_method_types: Stripe.PaymentLink.PaymentMethodType[];
        phone_number_collection: Stripe.PaymentLink.PhoneNumberCollection;
        restrictions: Stripe.PaymentLink.Restrictions;
        shipping_address_collection: Stripe.PaymentLink.ShippingAddressCollection;
        shipping_options: Stripe.PaymentLink.ShippingOption[];
        submit_type: Stripe.PaymentLink.SubmitType;
        subscription_data: Stripe.PaymentLink.SubscriptionData;
        tax_id_collection: Stripe.PaymentLink.TaxIdCollection;
        transfer_data: Stripe.PaymentLink.TransferData;
        url: string;
    }
    Index

    Properties

    id: string

    Unique identifier for the object.

    object: "payment_link"

    String representing the object's type. Objects of the same type share the same value.

    active: boolean

    Whether the payment link's url is active. If false, customers visiting the URL will be shown a page saying that the link has been deactivated.

    allow_promotion_codes: boolean

    Whether user redeemable promotion codes are enabled.

    application: string | Application | DeletedApplication

    The ID of the Connect application that created the Payment Link.

    application_fee_amount: number

    The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account.

    application_fee_percent: number

    This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account.

    billing_address_collection: Stripe.PaymentLink.BillingAddressCollection

    Configuration for collecting the customer's billing address. Defaults to auto.

    When set, provides configuration to gather active consent from customers.

    currency: string

    Three-letter ISO currency code, in lowercase. Must be a supported currency.

    custom_fields: Stripe.PaymentLink.CustomField[]

    Collect additional information from your customer using custom fields. Up to 3 fields are supported. You can't set this parameter if ui_mode is custom.

    Configuration for Customer creation during checkout.

    inactive_message: string

    The custom message to be displayed to a customer when a payment link is no longer active.

    Configuration for creating invoice for payment mode payment links.

    line_items?: ApiList<Stripe.LineItem>

    The line items representing what is being sold.

    livemode: boolean

    Has the value true if the object exists in live mode or the value false if the object exists in test mode.

    metadata: Metadata

    Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

    on_behalf_of: string | Stripe.Account

    The account on behalf of which to charge. See the Connect documentation for details.

    optional_items?: Stripe.PaymentLink.OptionalItem[]

    The optional items presented to the customer at checkout.

    payment_intent_data: Stripe.PaymentLink.PaymentIntentData

    Indicates the parameters to be passed to PaymentIntent creation during checkout.

    payment_method_collection: Stripe.PaymentLink.PaymentMethodCollection

    Configuration for collecting a payment method during checkout. Defaults to always.

    payment_method_types: Stripe.PaymentLink.PaymentMethodType[]

    The list of payment method types that customers can use. When null, Stripe will dynamically show relevant payment methods you've enabled in your payment method settings.

    phone_number_collection: Stripe.PaymentLink.PhoneNumberCollection

    Settings that restrict the usage of a payment link.

    shipping_address_collection: Stripe.PaymentLink.ShippingAddressCollection

    Configuration for collecting the customer's shipping address.

    shipping_options: Stripe.PaymentLink.ShippingOption[]

    The shipping rate options applied to the session.

    Indicates the type of transaction being performed which customizes relevant text on the page, such as the submit button.

    When creating a subscription, the specified configuration data will be used. There must be at least one line item with a recurring price to use subscription_data.

    The account (if any) the payments will be attributed to for tax reporting, and where funds from each payment will be transferred to.

    url: string

    The public URL that can be shared with customers.