使用 Thrinacia Atlas SaaS 实施自定义支付网关

本博客教程将展示一种可能的解决方案，该解决方案与在前端 AngularJS 或 Web UI 级别使用 Thrinacia Atlas SaaS（非本地解决方案）实施自定义支付网关相关。目前 Thrinacia Atlas 本身支持 Stripe 作为核心支付网关，但是如果您希望使用 Stripe 以外的东西进行支付处理，那么本教程可能对您有用。

请注意，此解决方案要求您拥有自己的 Web 服务器（启用 CORS），能够连接到 Thrinacia Atlas REST API 和自定义支付网关。客户端 Web 服务器充当所有在线交易的代理。

说明如何完成此操作的高级概览图如下所示。

基本上，前端 AngularJS 控制器和视图需要修改，以便当用户单击“贡献”时，交易详细信息不会发送到 Thrinacia Atlas 进行处理，而是发送到自定义 Web 服务器后端进行处理。这样的 Web 服务器将需要使用 CORS，因为浏览器将发出跨源请求。

然后，客户端 Web 服务器将需要使用支付信息（例如信用卡或银行卡）向自定义支付网关发出另一个请求，然后如果此类交易成功，则向 Thrinacia Atlas REST API 发出另一个请求以通过手动交易端点记录此类交易此处描述：  https ://origin.thrinacia.com/api-docs#account-campaign-pledge-manual-POST

当从您的网络服务器调用 Thrinacia Atlas REST API 端点进行手动交易时，您需要确保以门户管理员帐户的身份调用它。这意味着您需要将 Portal Administrator 用户名/密码令牌安全地保存在 Web 服务器上的某处，并通过直接服务器请求而不是从客户端浏览器调用端点，以确保凭据不会出​​于安全原因暴露给公众。

请注意，传递到您的客户端 Web 服务器的请求应包含客户标识符，例如电子邮件。然后，您可以通过以下端点轻松查找 person_id： https: //origin.thrinacia.com/api-docs#account-portal-person-GET  （再次以门户管理员帐户身份发送请求）。

如果 Thrinacia Atlas 上不存在这样的人，您将需要通过以下端点创建它，然后才能创建手动交易（除非您使用访客结账选项）：https:  //origin.thrinacia.com/api-docs#account -portal-person-POST

实现取决于您希望工作流如何运行。例如，如果您希望每个人都进行访客结帐，则不需要 person_id。但是，如果您希望通过手动交易获得有效的个人记录，则需要确保您可以检索或创建它。

Thrinacia Atlas 还提供两种处理贡献的模式（直接处理和后处理）。如果您需要模拟后处理，您可能需要在客户端 Web 服务器上编写一些代码，这些代码将在后台运行并处理之前排队并批准由自定义支付网关处理的交易，然后发送这些交易以进行手动交易处理到 Thrinacia Atlas。

附加说明和提示：

为了使事情更容易实施，您可以执行以下操作：

1. 输入 Stripe API 令牌的虚拟值，因为您可能不会使用 Stripe
2. 注释掉或禁用 Campaign Creator 上的 Funding Step，如果您使用直接交易功能，那么它会自动禁用
3. 您可能需要修改的 AngularJS 控制器和视图包括：“InlineContributionCtrl.js”、“PledgeCampaignCtrl.js”、“inline-contribution.html”和“pledge-campaign.html”
4. 编辑“submit()”函数以调用客户端；改变Restangular.one('campaign', $scope.campaign_id).one('承诺').customPOST(承诺信息)改为调用客户端 Web 服务器端点
5. 根据客户端 Web 服务器端点返回的状态（成功或失败），您可以根据客户端 Web 服务器的响应显示感谢模式或失败

使用每个 Thrinacia Atlas 帐户，您都可以通过 SFTP 修改代码。一些计划还提供 GIT 访问。如果您使用 GIT 访问，请确保使用正确的凭据通过 SFTP 或公钥登录。

CORS 的使用超出了本教程的范围，假定读者知道如何使用 CORS 并使用自己的 Web 服务器正确配置它。有关 CORS 的更多信息，请参阅以下教程：  http: //www.html5rocks.com/en/tutorials/corshttps://www.youtube.com/embed/lAegFz7ml0s