PHP Paypal Checkout SDK V2 -- "purchase_units" 的可能值是什么?

PHP Paypal Checkout SDK V2 -- what are the possible values for "purchase_units"?

我们正在构建一个 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 string required

The API caller-provided external ID for the purchase unit.

Minimum length: 1. Maximum length: 256.

payments object required

The comprehensive summary of payments for the purchase unit.

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

我们正在寻找可以在 purchase_units 中给出的其他字段,如果 reference_id 是 Paypal 参考或我们在我们的服务器上生成的东西(例如数据库订单行等) .) 。我假设 reference_id 是我们自己生成的东西,但由于来自 Paypal 的文档太少,这似乎并没有在任何地方得到真正的澄清。

问题:

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

  2. 我们如何将运费添加到此订单创建中?

作为奖励,哪里有关于此的任何可靠且未存档的 Paypal 文档?

谢谢。

I would assume the reference_id is something we generate ourselves

是的,看起来是这样。

如果你在 https://developer.paypal.com/docs/api/orders/v2/#definition-purchase_unit 下看,它说

reference_id - string - The API caller-provided external ID for the purchase unit.

因此,作为 API 的来电者,您必须提供此 ID。