madebythink / stripe-metadata-for-freeform

为 Freeform CraftCMS 插件提供对 Stripe 元数据字段的简化支持

4.0.0 2024-04-15 05:19 UTC

This package is auto-updated.

Last update: 2024-09-15 06:55:32 UTC


README

Stripe Metadata for Freeform 是一个简单的插件,它可以将收集到的 Freeform Pro 付款表单信息作为元数据附加到底层的 Stripe 付款和订阅。它通过检测字段使用简单的字段名匹配来实现,然后在付款成功时将其应用于 Stripe 实体(付款或订阅)。

注意:此插件与 Freeform 插件的开发者 Solspace 无关。

要求

  • Craft CMS 3.1+|4.0+
  • PHP 7.0+|8.0+
  • Solspace Freeform 3.3+|4.0+ (Pro)

概述

插件将监听 Freeform 提交的 EVENT_AFTER_SUBMIT 事件。如果提交包含付款或订阅,则插件将尝试附加元数据。首先,插件将遍历表单字段并提取任何以 metadata- 开头的字段,其余部分将是 Stripe 元数据字段处理。然后,它将尝试将元数据应用于单一付款的 Stripe PaymentIntent 或周期性付款的 Stripe 订阅。

示例

要使用此插件,请向您的表单中添加一个以 metadata- 开头的字段。元数据字段名称将是破折号之后的所有内容。例如,此表单有一个文本区域字段,其处理程序为 metadata-message,它将在 Stripe PaymentIntent/Subscription 上创建一个 message 字段。

Screenshot

在设置为收集单一付款的表单上,将添加元数据到 PaymentIntent

Screenshot

对于收集订阅的表单,元数据将添加到订阅中,可以从订阅或初始付款的 PaymentIntent 的元数据中访问。

Screenshot Screenshot