README

Riverty PHP API 客户端

此包是一个便利包装器，用于与 Riverty REST API 和旧版 SOAP API 通信。

安装

要安装客户端，请使用 composer。

Composer

将包包含在您的 composer.json 文件中

{
    "require": {
        "payintegrator/afterpay": "<VERSION>"
    }
}

...然后运行 composer update 并加载 composer 自动加载器

<?php
require 'vendor/autoload.php';

// ...

入门

要开始连接到 Riverty API，请查看 Riverty 开发者门户（https://developer.riverty.com），获取测试凭据和有关如何集成的更具体文档。

示例

示例文件夹包含所有可用操作的示例。

文档

更多文档可以在 developer.riverty.com 找到

贡献

我们热爱贡献，但请注意，每个贡献都必须经过审查和测试。如果您有建议的更改，您可以创建一个 Pull Request。

发行说明

2024.07.17 - 版本 4.5.0

• DP-1853 - 调整在送货客户处设置 customerCategory 元素值以处理 B2B 付款的逻辑。

2024.02.28 - 版本 4.4.0

• DP-1777 - 我们更新了 guzzlehttp 版本限制和订单行中的数量属性数据类型。

2024.02.14 - 版本 4.3.0

• DP-1764 - 我们更新了在创建订单行时获取毛单位价格的逻辑，并解决了使用十进制数量销售产品时授权和全额捕获请求中不同物品价格相关的问题。

2023.11.30 - 版本 4.2.0

• DP-1717 - 我们将 GuzzleHTTP 库的依赖项更新到版本 7.8.0。

2023.11.07 - 版本 4.1.0

• DP-1660 - 我们对计算增值税百分比和增值税金额的金额代码逻辑进行了优化，以处理传递给 number_format 函数的空值。
• DP-1661 - 我们在授权调用中添加了对 legalForm 值的支持。

2023.06.19 - 版本 4.0.0

• DP-1535 - 我们对所有在授权、捕获和退款调用中传达的金额进行了两位小数的舍入。
• DP-1559 - 我们在授权调用中添加了对 addressType 值的支持。

2022.12.20 - 版本 3.9.0

• DP-1396 - 我们已更新 REST API 的端点为新 Riverty 端点。
• DP-1383 - 我们已修复在 API 调用中包含零增值税值的问题，以支持零增值税值订单行。
• DP-1348 - 我们已更新翻译文件夹，以符合 Riverty 品牌变更。
• DP-1260 - 由于与 PHP 兼容性，我们将数字四舍五入到 4 位小数，而不是使用 round 和 number_format。
• DP-1251 - 我们已更新代码结构以支持新的 Pay in X 支付方式。

2022.11.17 - 版本 3.8.0

• DP-1251 - 我们已添加对新的 Pay in X 支付方式的支持。

2022.09.29 - 版本 3.7.0

• DP-1217 - 我们已更新获取插件提供商数据的方式。这是代码中的内部更改。无需进行任何更改。
• DP-1225 - 我们更改了四舍五入到 4 位小数的方式。
• DP-1224 - 我们在可用的支付方式调用中添加了 "country" 元素。这是为了确保在响应中提供正确的法律信息。
• DP-1218 - 我们对提交的产品链接和图像的 URL 进行了验证。如果 URL 无效，则将它们留空。
• DP-1249 - 我们已将 GuzzleHTTP 库的依赖项更新到版本 7.4.5。

2022.09.01 - 版本 3.6.0

• DP-1121 - 在请求中添加了对附加插件提供者数据的支持。
• DP-1026 - 在授权请求中添加了对PHP数据的支持。
• DP-1037 - 为additionalData元素创建默认值。
• DP-1097 - 在SOAP请求中添加了对附加平台数据的支持。
• DP-1025 - 改进了荷兰B2B数据的发送方式。
• DP-1158 - 在可用支付方式请求中添加了会话语言。

2022.05.16 - 版本 3.5.3

• DP-771 - 更新了对Guzzle 7.4.2的依赖。

2022.05.03 - 版本 3.5.2

• DP-771 - 更新了对Guzzle 7.3.0的依赖。
• DP-823 - 调整了电话号码格式的逻辑。

2022.03.15 - 版本 3.5.1

• DP-840 - 未分配vatCategory及其依赖。
• DP-823 - 调整了电话号码格式的逻辑。

2022.01.18 - 版本 3.5.0

• DP-805 - 不要显示“订单过多”的拒绝消息。
• DP-789 - 修复了vatAmount中过多小数的问题。

2021.09.29 - 版本 3.4.0

• DP-786 - 在授权和可用支付方式调用中添加插件数据字段。

2021.09.23 - 版本 3.3.0

• DP-773 - 从银行账户验证、直接借记和分期付款中移除BIC。

2021.06.02 - 版本 3.2.0

• DP-736 - 允许没有住宅号码的地址，并在空时移除住宅号码和住宅号码元素。
• DP-749 - 从API调用中移除MerchantID。

2021.04.20 - 版本 3.1.0

• DP-741 - 限制housenumberaddition中的字符数。

2021.02.08 - 版本 3.0.0

• DP-673 - 添加了对Campaign支付方式的 support。
• DP-702 - 检查特殊字符上的首字母（SOAP NL/BE）。
• 更新版权信息。

2020.11.23 - 版本 2.9.1

• DP-462 - 更新了调用取消请求的功能。

2020.11.16 - 版本 2.9.0

• DP-675 - 添加了调用get_order请求的功能。

2020.10.20 - 版本 2.8.0

• DP-664 - 在使用REST进行订单管理请求时，设置小数的最大值。

2020.07.09 - 版本 2.7.0

• DP-659 - 更新了SOAP和REST测试环境的端点。

2020.05.27 - 版本 2.6.0

• DP-657 - 更新了NL SOAP测试环境的端点。

2020.05.19 - 版本 2.5.0

• DP-641 - 为SOAP发票限制添加错误消息。
• DP-652 - 修复了TotalNetAmount在支付方式调用中不可用的问题。

2020.03.20 - 版本 2.4.0

• DP-627 - 添加了对GroupId元素的支持。

2020.03.03 - 版本 2.3.0

• DP-345 - 将totalNetAmount添加到可用支付方式的请求中。
• DP-619 - 在NL中通过REST添加了对直接借记银行详情的支持。
• DP-627 - 添加了对GroupId元素的支持。

2019.11.07 - 版本 2.2.0

• DP-562 - 添加了对NL/BE通过REST的支付支持。
• DP-598 - 添加了对德国B2B的支持。

2019.06.03 - 版本 2.1.0

• DP-491 - 添加了对法语翻译的支持。
• DP-345 - 添加了对Account / Flex支付方式的 support（APS-164）。

2019.01.29 - 版本 2.0.0

• DP-532 - 修复了特殊字符的问题。现在在SOAP中的描述只允许A-Z、a-z、0-9、空格和破折号。

2018.11.28 - 版本 1.9.0

• DP-492 - PHP - 添加对沙盒的支持。
• 错误修复 - 清理手机电话号码。
• 错误修复 - 在验证文件中添加了缺失的逗号。
• 版权变更 2018 年至 2019 年。

2018.08.16 - 版本 1.8.0

• DP-437 - PHP - 添加对SOAP请求订单状态的支持。
• DP-30 - PHP - 添加CustomerLookup功能。
• DP-423 - PHP - 在Void操作中不要将totalamount除以100。
• DP-390 - PHP - 根据德国或其他国家的不同，在分期付款调用中做出差异，因为只有德国需要直接借记。
• DP-305 - PHP - 添加对配置文件跟踪和客户个人评分的支持。

2018.04.11 - 版本 1.7.0

• DP-288 - PHP - 修改错误报告以防止内存泄漏
• DP-289 - PHP - 当客户送货地址为空时清除其值
• DP-290 - PHP - 实现银行账户请求的验证
• DP-163 - PHP - 为德国直接扣款请求添加特定字段和功能
• DP-296 - PHP - 在负值（折扣行）上计算增值税金额时出现问题

2018.02.07 - 版本 1.6.0

• DP-137 - 添加对分期付款请求的支持
• DP-211 - 为 OneAPI 连接实现产品图像和产品 URL
• DP-224 - 在 OneApi 请求中添加个人识别号码

2018.01.22 - 版本 1.5.0

• DP-134 - 为 OneAPI 连接添加商户 ID
• DP-128 - 通过服务恢复设置订单国家的能力并添加新的国家代码

2017.10.16 - 版本 1.4.0

• DP-104 - 当发生异常时创建调试日志
• DP-105 - 当在 REST 请求中发送增值税金额时计算增值税百分比

2017.09.26 - 版本 1.3.0

• REST: 将 vatAmount 可能性添加到请求中
• 错误修复：将 SOAP 请求作为可读字符串返回到调试

2017.09.12 - 版本 1.2.9

• 错误修复：由于与客户端抽象类的兼容性，将国家添加回 getWebserivceurl 函数
• 错误修复：REST 订单管理操作使用欧元而不是欧分
• REST: 在订单管理任务中添加对 SOAP 客户端的向后兼容性，所有请求均以欧分执行
• REST: 按照SOAP客户端的相反金额发送退款
• REST: 产品 ID 不能超过 50 个字符
• REST: 将对 convertPrice 函数的支持添加为负值
• 更新代码以符合编码标准
• REST: 由于订单管理操作，更改设置国家的优先级
• REST: 检查 DOB 是否已设置，否则发送空值
• REST: 添加默认国家和新调试功能

2017.07.17 - 版本 1.2.8

• 错误修复：createOrderLine 应具有与父级相同的结构

2017.07.17 - 版本 1.2.7

• Rest: 删除未填写的字段
• Rest: 添加通用称呼
• 对拒绝错误进行改进，包括荷兰语和英语
• Rest: 添加特定于国家的增值税规则
• 错误修复：housenumberaddition 未在 SOAP 中发送

2017.06.16 - 版本 1.2.6

• 重写检查使用 Soap 或 Rest 以使用变量 $useRest，因为构造参数并不总是起作用。

2017.06.16 - 版本 1.2.5

• 由于 composer 未更新到正确版本，额外发布

2017.06.15 - 版本 1.2.4

• 错误修复：useRest 使每个请求都使用 REST 客户端

2017.06.15 - 版本 1.2.3

• 检查 Rest 客户端中是否存在 firstname

2017.06.10 - 版本 1.2.2

• 由于字符编码问题，将 guzzle 请求从 json 更改为 body/json
• 添加更多用户友好且清晰的验证消息
• 为业务对业务请求添加验证消息

2017.05.10 - 版本 1.2.1

• 错误修复：B2B 人员对象中的拼写错误
• REST: 为 Google 数据和产品 URL 添加特定字段
• REST: 将 totalGrossAmount 的金额从欧分更改为欧元
• REST: 在人员数据中添加 careOf 字段
• REST: 仅当可用时添加手机电话号码
• REST: 添加风险数据 ipAddress 和 existingCustomer
• REST: 添加附加数据（pluginProvider、pluginVersion、shopUrl、shopPlatform、shopPlatformVersion）

2017.04.10 - 版本 1.2.0

• 与订单中的特殊字符兼容
• 更新缺少银行账户号码的拒绝文本
• 将旧 AfterPay 库的重大迁移到新库，支持旧 AfterPay SOAP 以及新的 AfterPay.IO REST 接口