Stripe.Resources.PaymentLink (tiger_stripe v0.4.0)

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: term(),
  after_completion: term(),
  allow_promotion_codes: term(),
  application: term(),
  application_fee_amount: term(),
  application_fee_percent: term(),
  automatic_tax: term(),
  billing_address_collection: term(),
  consent_collection: term(),
  currency: term(),
  custom_fields: term(),
  custom_text: term(),
  customer_creation: term(),
  id: term(),
  inactive_message: term(),
  invoice_creation: term(),
  line_items: term(),
  livemode: term(),
  managed_payments: term(),
  metadata: term(),
  name_collection: term(),
  object: term(),
  on_behalf_of: term(),
  optional_items: term(),
  payment_intent_data: term(),
  payment_method_collection: term(),
  payment_method_options: term(),
  payment_method_types: term(),
  phone_number_collection: term(),
  restrictions: term(),
  shipping_address_collection: term(),
  shipping_options: term(),
  submit_type: term(),
  subscription_data: term(),
  tax_id_collection: term(),
  transfer_data: term(),
  url: term()
}
  • 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 - If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.
  • managed_payments - Settings for Managed Payments for this Payment Link and resulting CheckoutSessions, PaymentIntents, Invoices, and Subscriptions. Nullable. Expandable.
  • 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_options - Payment-method-specific configuration. Nullable. Expandable.
  • 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()