feat: support itemized checkout payloads

Author: root

composer.json

@@ -1,5 +1,6 @@
 {
     "name": "kaninstein/multi-acquirer-checkout",
+    "version": "1.0.16",
     "description": "Multi-acquirer checkout package with DDD architecture for Laravel",
     "keywords": [
         "laravel",

src/Application/DTOs/PaymentRequest.php

@@ -11,6 +11,7 @@
 {
     /**
      * @param array<string, mixed> $metadata
+     * @param array<int, array<string, mixed>> $items
      */
     public function __construct(
         public Money $amount,
@@ -23,6 +24,7 @@ public function __construct(
         public bool $merchantAbsorbsFinancing = false,
         public string $feeResponsibility = 'buyer',
         public ?float $platformFeeRate = null,
+        public array $items = [],
     ) {}
 
     public function isCardPayment(): bool

src/Infrastructure/Gateways/Pagarme/PagarmeGateway.php

@@ -232,15 +232,33 @@ private function configureFacade(): void
      */
         private function buildOrderData(PaymentRequest $request): array
     {
-        $order = [
-            'items' => [
+        $items = [];
+        foreach ($request->items as $item) {
+            $amountCents = (int) ($item['amount_cents'] ?? 0);
+            if ($amountCents <= 0) {
+                continue;
+            }
+            $items[] = [
+                'amount' => $amountCents,
+                'description' => (string) ($item['description'] ?? $item['name'] ?? $request->metadata['description'] ?? 'Checkout'),
+                'quantity' => (int) ($item['quantity'] ?? 1),
+                'code' => (string) ($item['code'] ?? $item['id'] ?? $request->metadata['item_code'] ?? 'ITEM-1'),
+            ];
+        }
+
+        if ($items === []) {
+            $items = [
                 [
                     'amount' => $request->amount->amountInCents,
                     'description' => (string) ($request->metadata['description'] ?? 'Checkout'),
                     'quantity' => 1,
                     'code' => (string) ($request->metadata['item_code'] ?? 'ITEM-1'),
                 ],
-            ],
+            ];
+        }
+
+        $order = [
+            'items' => $items,
             'customer' => $this->buildCustomerData($request),
             'payments' => [
                 $this->buildPaymentData($request),

src/Presentation/Http/Controllers/CheckoutController.php

@@ -37,6 +37,11 @@ public function process(Request $request): JsonResponse
             'card.cvv' => ['sometimes', 'string'],
             'card.token' => ['sometimes', 'string'],
             'metadata' => ['sometimes', 'array'],
+            'items' => ['sometimes', 'array'],
+            'items.*.amount_cents' => ['sometimes', 'integer', 'min:1'],
+            'items.*.quantity' => ['sometimes', 'integer', 'min:1'],
+            'items.*.code' => ['sometimes', 'string'],
+            'items.*.description' => ['sometimes', 'string'],
             'gateway' => ['sometimes', 'string'],
             'platform_fee_rate' => ['sometimes', 'numeric', 'min:0', 'max:1'],
             'merchant_absorbs_financing' => ['sometimes', 'boolean'],
@@ -67,6 +72,7 @@ public function process(Request $request): JsonResponse
             merchantAbsorbsFinancing: (bool) ($validated['merchant_absorbs_financing'] ?? false),
             feeResponsibility: (string) ($validated['fee_responsibility'] ?? 'buyer'),
             platformFeeRate: array_key_exists('platform_fee_rate', $validated) ? (float) $validated['platform_fee_rate'] : null,
+            items: (array) ($validated['items'] ?? []),
         ));
 
         return response()->json([