签约

付款 订阅

了解如何通过将客户注册到您网站上的产品来创建注册(也称为订阅)。在继续之前,我们建议您熟悉订阅的工作原理。请查看我们的 订阅文档介绍 for further details.


尽管Chargify几乎可以使用API​​集成处理任何情况,但该注册指南完全贯穿了在Chargify中创建订阅的基础。

  1. Chargify的 注册方法
  2. 支付方式 可供订阅
  3. 如何与客户打交道 多个订阅
  4. 零件 数量 以及如何使用它们自定义计费

注册方法

有很多方法可以实际注册客户到您的企业。请探索以下内容,并查看它们在您的方案中如何使用:

并非所有方法都适用于您的独特业务,但是我们提供的方法几乎可以适用于您可能想到的任何业务模型。

手动(在Chargify内)

创建简单订阅的第一个机会是在您的Chargify帐户中。请确保您拥有至少一个可以在以下示例中使用的产品。请参考这个浓缩 指南 为了通过Chargify应用程序创建简单的订阅。

这种形式的注册对于数量少(订阅数量少)的企业非常有用,并且由于不需要集成任何东西,因此合作速度最快。

有关订阅的更多信息,请参见 订阅 documentation.

您会看到这种方法非常简单,但是显然您不能永远手动注册客户-有一个很好的解决方案!

公开注册页面(PSP)

公开页面是高度可定制的白标签页面,您可以将其用作订阅业务的面向公众的一面。它们是与Chargify平台集成的快速简便的方法,而不必担心自己收集信用卡信息或编写自定义代码。

在所有Chargify计划中,商家可以使用两种类型的“公共注册页面”:

  1. 将为每个新产品自动创建一个公共注册页面,并允许人们注册您当前使用的任何产品。
  2. A 自助页面 为每个有效订阅自动创建,并允许客户管理付款方式。

如果您需要有关配置公共页面外观,信息和行为的信息,请参阅 公用页面默认设置.

使用“公共注册页面”时,您有一个特定的URL,可以将客户发送到该URL,从而允许他们进行注册-创建订阅,然后将其添加到您的站点。

我们建议您回顾一下 公开注册页面有效, 为了更好地了解Chargify可以与您的系统集成的多种方式。 “公共注册页面”在开发过程中也可以是有用的工具,可以通过我们的预制表单和您的表单来测试简单的注册以进行故障排除。

在某些情况下,“公共注册页面”无法完全解决您与Chargify集成时可能需要的特定情况-这就是为什么我们公开公共API供您由应用程序使用。

API

使用公共API创建订阅就像发送以下基本信息一样简单:

  1. 产品 -订阅将客户链接到您网站上可用的产品,因此在创建订阅时需要指定该产品。
  2. 顾客 -客户是消费您的产品/服务的人。这可以是对站点中现有客户的引用,也可以是对全新客户的引用。
  3. 付款详情 -对于付费产品或具有任何可计费组成部分的产品,我们需要知道如何从中获取付款。

  • 为了 自动 通过信用卡或银行详细信息(称为自动清算中心(ACH))进行结算。

  • 为了 发票 帐单中,付款不会自动进行,但仍可以通过以下方式手动完成:非电子方式并手动标记,或使用信用卡。

为了 example, the following POST to the subscription create API endpoint would create a subscription:

{
  "subscription": {
    " 产品 _handle": "basic",
    " 顾客 _attributes": {
      "first_name": "Alysa",
      "last_name": "Test",
      "email": "alysa@example.com",
      "reference": "1234-AB"
    },
    "credit_card_attributes": {
      "full_number": "1",
      "expiration_month": "10",
      "expiration_year": "2020"
    }
  }
}

有关更多信息,请参见 用于创建订阅的API文档.

有关更高级的订阅创建方案,请参阅 高级订阅创建示例.

直接充电

直接充电 允许您通过自己网站上直接发布到Chargify的表单来创建Chargify资源(例如订阅)。 Chargify收到表单提交后,用户将被重定向回您自己的站点。重定向传达提交结果,以便您的网站可以决定如何响应用户。在行业中,有时将此流称为“透明重定向”。

例:

<form action="//api.ikvrej.icu/api/v2/signups" method="post">
  <!-- Secure Parameters -->
  <input type="hidden" name="secure[api_id]" value="my_api_id"/>
  <input type="hidden" name="secure[data]" value="redirect_uri=#"/>
  <input type="hidden" name="secure[signature]" value="the_calculated_signature_here"/>
  <!-- Resource parameters here-->
  <!-- For brevity, this form contains no labels, only inputs :) -->
  <input type="hidden" name="signup[product][handle]" value="basic" />
  <input type="text" name="signup[customer][first_name]" value="Alysa" />
  <input type="text" name="signup[customer][last_name]" value="Test" />
  <input type="text" name="signup[customer][reference]" value="1234-AB" />
  <input type="text" name="signup[customer][email]" value="alysa@example.com" />
  <input type="text" name="signup[payment_profile][first_name]" value="Alysa" />
  <input type="text" name="signup[payment_profile][last_name]" value="Test" />
  <input type="text" name="signup[payment_profile][card_number]" value="1" />
  <input type="text" name="signup[payment_profile][expiration_month]" value="10" />
  <input type="text" name="signup[payment_profile][expiration_year]" value="2020" />
  <input type="submit" value="Submit"/>
</form>

In the above example, you would need to use the correct api_id, set an appropriate data value and calculate the correct signature. The system will not allow submissions if the basic 验证 不满足要求。

支付方式

订户的付款方式可以是自动或发票开票。提醒一下,使用自动计费,续订时会自动向客户收费。使用发票开票,续订时不会自动向客户收费。在续订时,会创建发票并将其发送给客户。然后,当您从客户处收到发票时,可以手动记录该发票的付款。

有关更多信息,请参见 支付方式 .

税收

如果您的意图是通过收取订户税 阿瓦拉税 或者 关税 , there are a few considerations to be made regarding collecting subscription data. For subscribers to be eligible to be taxed, the following information for the 顾客 object or payment_profile object must by supplied:

多个订阅

Chargify并不仅限于每个客户只允许一个订阅,您可以使用单独或链接的付款方式为单个客户进行多个订阅。

In the following example, the existing customer with reference (shown as 顾客 _reference below) value 1234-AB will be subscribed to the product specified. You may also specify the customer_id, but it’s far more useful to map a user on your system to a customer on Chargify using this reference value. It’s commonly filled with the user’s unique identifier (ie. the userID) which makes referencing the customer in Chargify very simple as there are customer reference value filters in many methods.

{
  "subscription": {
    " 产品 _handle": "basic",
    " 顾客 _reference": "1234-AB",
    "credit_card_attributes": {
      "full_number": "1",
      "expiration_month": "10",
      "expiration_year": "2020"
    }
  }
}

为了 more information about the 顾客 _reference and 顾客 _id values, please see the API文档 .

通过包含客户参考或客户ID,Chargify Direct也可以用于为现有客户创建其他订阅。通过包括属于该客户的付款资料ID,订阅可以选择重新使用现有的付款资料。

<input type="hidden" name="signup[customer][reference]" value="abc-123" /> 或者 
<input type="hidden" name="signup[customer][id]" value="12345" />

<input type="hidden" name="signup[payment_profile][id]" value="67890" />

成分

一个非常常见的初始注册步骤是分配一定数量的一个或多个组件,这些组件对应于其订阅的初始状态。一个简单的示例是订阅服务,该服务每月发送X个小部件。客户已注册了“每月5个小部件”产品,因此您可以分配以下五个小部件组件:

{
  "subscription": {
    " 产品 _handle": "basic",
    " 顾客 _attributes": {
      "first_name": "Alysa",
      "last_name": "Test",
      "email": "alysa@example.com",
      "reference": "1234-AB"
    },
    "credit_card_attributes": {
      "full_number": "1",
      "expiration_month": "10",
      "expiration_year": "2020"
    },
    " 组件 ":[
      {
        "component_id": 1,
        "allocated_quantity": 5
      }
    ]
  }
}

有关组件以及如何使用此强大功能自定义注册过程的更多信息-请参阅 组件 .

为了深入了解组件在Chargify中的功能,我们建议使用以下资源:


下一步