Stripe.Resources.PaymentLink (tiger_stripe v0.1.10)

Copy Markdown View Source

PaymentLink

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

Summary

Types

t()

Functions

expandable_fields()
object_name()

Types

t()

@type t() :: %Stripe.Resources.PaymentLink{
  active: boolean(),
  after_completion: Stripe.Resources.PaymentLink.AfterCompletion.t(),
  allow_promotion_codes: boolean(),
  application: String.t() | Stripe.Resources.Application.t(),
  application_fee_amount: integer(),
  application_fee_percent: float(),
  automatic_tax: Stripe.Resources.PaymentLink.AutomaticTax.t(),
  billing_address_collection: String.t(),
  consent_collection: Stripe.Resources.PaymentLink.ConsentCollection.t(),
  currency: String.t(),
  custom_fields: [Stripe.Resources.PaymentLink.CustomFields.t()],
  custom_text: Stripe.Resources.PaymentLink.CustomText.t(),
  customer_creation: String.t(),
  id: String.t(),
  inactive_message: String.t(),
  invoice_creation: Stripe.Resources.PaymentLink.InvoiceCreation.t(),
  line_items: Stripe.Resources.PaymentLink.LineItems.t() | nil,
  livemode: boolean(),
  metadata: %{required(String.t()) => String.t()},
  name_collection: Stripe.Resources.PaymentLink.NameCollection.t() | nil,
  object: String.t(),
  on_behalf_of: String.t() | Stripe.Resources.Account.t(),
  optional_items: [Stripe.Resources.PaymentLink.OptionalItems.t()] | nil,
  payment_intent_data: Stripe.Resources.PaymentLink.PaymentIntentData.t(),
  payment_method_collection: String.t(),
  payment_method_types: [String.t()],
  phone_number_collection:
    Stripe.Resources.PaymentLink.PhoneNumberCollection.t(),
  restrictions: Stripe.Resources.PaymentLink.Restrictions.t(),
  shipping_address_collection:
    Stripe.Resources.PaymentLink.ShippingAddressCollection.t(),
  shipping_options: [Stripe.Resources.PaymentLink.ShippingOptions.t()],
  submit_type: String.t(),
  subscription_data: Stripe.Resources.PaymentLink.SubscriptionData.t(),
  tax_id_collection: Stripe.Resources.PaymentLink.TaxIdCollection.t(),
  transfer_data: Stripe.Resources.PaymentLink.TransferData.t(),
  url: String.t()
}
  • active - 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.
  • after_completion - Expandable.
  • allow_promotion_codes - Whether user redeemable promotion codes are enabled.
  • application - The ID of the Connect application that created the Payment Link. Nullable. Expandable.
  • application_fee_amount - 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. Nullable.
  • application_fee_percent - This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account. Nullable.
  • automatic_tax - Expandable.
  • billing_address_collection - Configuration for collecting the customer's billing address. Defaults to auto. Possible values: auto, required.
  • consent_collection - When set, provides configuration to gather active consent from customers. Nullable. Expandable.
  • currency - Three-letter ISO currency code, in lowercase. Must be a supported currency. Format: ISO 4217 currency code.
  • custom_fields - 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. Expandable.
  • custom_text - Expandable.
  • customer_creation - Configuration for Customer creation during checkout. Possible values: always, if_required.
  • id - Unique identifier for the object. Max length: 5000.
  • inactive_message - The custom message to be displayed to a customer when a payment link is no longer active. Max length: 5000. Nullable.
  • invoice_creation - Configuration for creating invoice for payment mode payment links. Nullable. Expandable.
  • line_items - The line items representing what is being sold. Expandable.
  • livemode - Has the value true if the object exists in live mode or the value false if the object exists in test mode.
  • 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.
  • name_collection - Expandable.
  • object - String representing the object's type. Objects of the same type share the same value. Possible values: payment_link.
  • on_behalf_of - The account on behalf of which to charge. See the Connect documentation for details. Nullable. Expandable.
  • optional_items - The optional items presented to the customer at checkout. Nullable. Expandable.
  • payment_intent_data - Indicates the parameters to be passed to PaymentIntent creation during checkout. Nullable. Expandable.
  • payment_method_collection - Configuration for collecting a payment method during checkout. Defaults to always. Possible values: always, if_required.
  • payment_method_types - 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. Nullable.
  • phone_number_collection - Expandable.
  • restrictions - Settings that restrict the usage of a payment link. Nullable. Expandable.
  • shipping_address_collection - Configuration for collecting the customer's shipping address. Nullable. Expandable.
  • shipping_options - The shipping rate options applied to the session. Expandable.
  • submit_type - Indicates the type of transaction being performed which customizes relevant text on the page, such as the submit button. Possible values: auto, book, donate, pay, subscribe.
  • subscription_data - 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. Nullable. Expandable.
  • tax_id_collection - Expandable.
  • transfer_data - The account (if any) the payments will be attributed to for tax reporting, and where funds from each payment will be transferred to. Nullable. Expandable.
  • url - The public URL that can be shared with customers. Max length: 5000.

Functions

expandable_fields()

object_name()