应用市场
附加组件 v1.0.14

Wallet payments

概述

连接到 PayPal。你的顾客在 PayPal 页面上,用自己的 PayPal 账户支付一张发票或任何带金额的记录。顾客在那里批准付款后返回;随后 Adminium 收取这笔钱(PayPal 称之为“捕获”),并把它记到这条记录上,只记一次。如果顾客一直没有返回,就由 Webhook 或 Adminium 自己的核查来收取;被 PayPal 暂扣的付款会显示为“处理中”,并附上 PayPal 给出的原因。卖家是你的店铺:它需要自己的 PayPal 企业账户,钱从顾客直接进入这个账户。Adminium 不持有任何支付账户、任何自己的凭据,也不经手任何钱款,不处理任何交易;顾客在 PayPal 页面上输入的任何内容都不会到达你的服务器。在 Studio → 付款 中设置,先用沙盒:每种模式各一个带客户端 ID 和密钥的 REST 应用和一个 Webhook,然后以沙盒买家身份做一笔测试付款,它不会向你的表写入任何内容。退款可以在记录的付款面板或“动态”中发起,在 PayPal 控制台做的退款也会被记录。有争议的付款会被跟进,直到 PayPal 作出裁决;你在 PayPal 控制台答复争议。它只提供一种付款方式,即顾客的 PayPal 账户,支持 PayPal 支持的 24 种货币,其中 HUF、JPY 和 TWD 只能按整数单位收取。需要 Adminium 0.3.33 或更高版本,并使用 443 端口上的公开 https 地址,PayPal 只向这个端口发送 Webhook。

它依附在什么上

这一个不绑定某个应用。它在 Adminium 本身中工作,也在任何承载附加组件的应用中工作。

连接后它可以做什么

它需要你自己的 PayPal 企业账户中的一个 REST 应用,沙盒和正式模式各一个:它的客户端 ID、密钥和它的 Webhook 的 ID。这个密钥能打开整个 PayPal 账户(PayPal 没有权限更窄的密钥),所以三者都按模式分别加密保存在你的服务器上,附加组件的任何部分都不会到达浏览器。每个 Webhook 的签名都在你的服务器上用 Webhook ID 校验。付款只会写入你在“可付款的内容”中选定的表里的行。它的服务器部分只能调用下面六个地址,别无其他。

它的服务端代码可以访问的地址

  • api-m.paypal.com
  • api-m.sandbox.paypal.com
  • www.paypal.com
  • www.sandbox.paypal.com
  • api.paypal.com
  • api.sandbox.paypal.com

这份清单就是全部:访问其他地址会被拒绝并记录下来。

连接时需要什么

一个 API 密钥

它增加了什么

它出现在哪里 3
  • 在 Adminium 中:Studio → 付款 → 设置 下它的卡片,带有清单:沙盒应用、沙盒 Webhook、发送测试付款、正式应用、正式 Webhook、第一笔正式付款已到账
  • 在记录的付款页面上:“使用 PayPal 付款”,把顾客带到 PayPal 页面
  • 在记录的付款面板和“动态”中:它收取的付款,以及相关的退款和争议
它带来的数据表 0

没有 —— 它不带自己的数据表。

需要配置的设置 3
  • 客户端 ID
  • 密钥
  • Webhook ID

如果你把它关掉

断开连接会移除附加组件的界面。它绝不会删掉自己创建的数据表、写入的文件或添加的记录 —— 它写下的一切都留在你的数据库里。 交给它的凭据会随之被吊销并删除。

会留下什么

已记录的每一笔付款和退款都会保留:在对应的记录上、在“动态”里,以及你选定的自有付款表中(如果你选了的话)。它没有带来自己的表。手动付款方式和手动记录付款照常可用,你的 PayPal 账户及其中的钱款不受任何影响。

会消失什么

它卡片上的“断开”提供两种做法。停止新付款:不再发起新的付款,Adminium 保留凭据,用来完成仍在等待的付款并办理退款。删除密钥:凭据从这台服务器上删除,Adminium 无法再通过 PayPal 完成付款或办理退款。在此删除凭据不会在 PayPal 作废它们;为安全起见,请在 PayPal 开发者控制台中为这个应用生成新的密钥。

关于演示

本站的任何演示都不会真的调用别人的服务。每个附加组件都自带一个替代传输层,回答来自内置数据,并且默认就是开着的。真正的凭据属于自托管的选择,写在该附加组件自己的 README 里。

如何打开它 本网站上的演示都不包含它。在你自己的 Adminium(0.3.33 或更高版本)里,在“附加组件”中安装 Wallet payments,打开 Studio → 付款,按它卡片上的清单操作,先用沙盒。每个测试付款页面还提供演示服务,完全不需要账户,因此在连接任何东西之前,就能试完整个流程,包括退款。

Adminium 与该公司没有关联。