Add PayPal/gateway line item details

[amacneil]

I'm working on passing line item details to PayPal (and other gateways which support this - see #32) and looking for feedback on the API.

It currently looks like this:

$request->setItems(array(
    array('name' => 'Food', 'quantity' => 1, 'price' => '40.00'),
    array('name' => 'Drinks', 'quantity' => 2, 'price' => '6.00'),
));

// or

$items = new ItemBag;
$items->add(array('name' => 'Food', 'quantity' => 1, 'price' => '10.00'));
$request->setItems($items);

// or

$items = new ItemBag;
$item = new Item;
$item->setName('Cheese');
$item->setQuantity(1);
$item->setPrice(99.00);
$items->add($item);
$request->setItems($items);

Similar to the CreditCard object, you can either pass an array and have the ItemBag object instantiated for you, or you can pass the actual item and it will be used.

Feedback welcome.

[benjam-es]

Hi Adrian, can you help. I'm unsure where to set items. I see it says request, but I cant find the equivalent in the sagepay in frame code I am using.

[amacneil]

I don't think line items are supported on the sagepay gateway yet sorry.

[benjam-es]

Sagepay allow passing line items as basket information. I would have a go at it, but not sure where to start.

[benjam-es]

I can see that in sagepay abstract request that getItemData would need to cycle through the item bag to produce a 'basket' parameter within $data (i think) to match their example:

4:Pioneer NSDV99 DVD-Surround Sound System:1:424.68:74.32:499.00: 499.00:Donnie Darko Director’s Cut:3:11.91:2.08:13.99:41.97: Finding Nemo:2:11.05:1.94:12.99:25.98: Delivery:---:---:---:---:4.99 

And that I would need to edit the auth request and complete request files to merge that into the data array..

But In my code I would be unsure where to use it. I.e. I instantiate a serverGateway class, but need to call the setItems method on a request class..

Edit:
Sagepay basket example on page 49..... http://www.sagepay.co.uk/file/1161/download-document/SERVERProtocolandIntegrationGuidelinesV3%200.pdf?token=M_AUH61Et9gH6Eer5WLPCq7lJorv9bLlYlKqLDGa9-8

[judgej]

I've just raised a ticket concerning the cart item implementation - I cannot see a way to add custom fields, such as the Net and VAT fields in the SagePay example. Not sure if I've raised it against the right repository, so here it is:

thephpleague/omnipay-common#11

@benjam-es I am trying out the basket like this:

$gateway = \Omnipay::create('Gateway_Name');

// "purchase" is an action; could be authorize or some custom action specific to a gateway.
$request = $gateway->purchase($data);

// Create a basket of items.
$basket = new \Omnipay\Common\ItemBag();
$item = new \OmnipayCommon\Item(['name' => 'item name 1', ...]);
$basket->add($item);

// Or just add the data to the basket and let add() turn that into an item.
$basket->add(['name' => 'item name 2', ...]);
$request->setItems($basket);

// Or just pass the data in to the request and let setItems() create the whole basket.
$request->setItems(['name' => 'item name 1', ...], ['name' => 'item name 2', ...], ...);

$response = $request->send();

My problem is that the basket can only consist of name/quantity/price and nothing more, which limits it pretty much to just PayPal.

A gateway could override the Item class to add its own setters and getters, but that defeats the object of having a unified API to learn.

[ericmuigai]

How do I view these items on PayPal history?