PHP Paypal Checkout SDK V2——“purchase_units”的可能值是什么？

Question

我们正在构建一个 Paypal PHP V2 结帐，而 github 上的文档没有显示purchase_units 的可能预期数据。 Paypal 在他们的智慧中也关闭了问题跟踪。

Github：https://github.com/paypal/Checkout-PHP-SDK

Paypal 示例代码：

创建订单

// Construct a request object and set desired parameters
// Here, OrdersCreateRequest() creates a POST request to /v2/checkout/orders
use PayPalCheckoutSdk\Orders\OrdersCreateRequest;
$request = new OrdersCreateRequest();
$request->prefer('return=representation');
$request->body = [
                     "intent" => "CAPTURE",
                     "purchase_units" => [[
                         "reference_id" => "test_ref_id1",
                         "amount" => [
                             "value" => "100.00",
                             "currency_code" => "USD"
                         ]
                     ]],
                     "application_context" => [
                          "cancel_url" => "https://example.com/cancel",
                          "return_url" => "https://example.com/return"
                     ] 
                 ];

这很好，但我们找不到任何文档说明可以或应该在 "purchase_units"（或此数据集中的任何其他字段）数组中给出哪些值。

Paypal 自己的“purchase_units”文档链接到此处： https://developer.paypal.com/docs/api/orders/v2/#definition-model-update_purchase_unit_request

其中规定：

model-update_purchase_unit_request

reference_id 需要字符串

API 调用者为购买单位提供的外部 ID。

最小长度：1。 最大长度：256。

payments 需要对象

采购单位付款的综合摘要。

不完整或引用其他内容（示例代码中没有支付对象）。

我们正在寻找可以在 purchase_units 中提供哪些其他字段，以及 reference_id 是否是 Paypal 参考或我们生成的服务器上的某些内容（例如数据库订单行等）。我会假设reference_id 是我们自己生成的，但由于 Paypal 提供的文档很少，这似乎并没有在任何地方得到真正的澄清。

问题：

1. 我们可以在"purchase_units" 请求正文中使用哪些字段

2. 我们如何在此订单创建中添加运费？

另外，哪里有关于这方面的可靠且未归档的 Paypal 文档？

谢谢。

Answer 1

我会假设 reference_id 是我们自己生成的东西

是的，看来是这样。

如果您查看https://developer.paypal.com/docs/api/orders/v2/#definition-purchase_unit，那里会显示，

reference_id - 字符串 - API 调用者为采购单元提供的外部 ID。

因此，作为 API 的调用者，您必须提供此 ID。