PHP Paypal 結帳 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 object

采購單位付款的綜合摘要。

哪個不完整或引用其他內容（示例代碼中沒有付款 object）。

我們正在尋找可以在 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。