1
0
Files
PayPal-PHP-Server-SDK/doc/models/item-request.md
2025-11-06 20:07:39 +00:00

3.2 KiB

Item Request

The details for the items to be purchased.

Structure

ItemRequest

Fields

Name Type Tags Description Getter Setter
name string Required The item name or title.

Constraints: Minimum Length: 1, Maximum Length: 127
getName(): string setName(string name): void
unitAmount Money Required The currency and amount for a financial transaction, such as a balance or payment due. getUnitAmount(): Money setUnitAmount(Money unitAmount): void
tax ?Money Optional The currency and amount for a financial transaction, such as a balance or payment due. getTax(): ?Money setTax(?Money tax): void
quantity string Required The item quantity. Must be a whole number.

Constraints: Maximum Length: 10, Pattern: ^[1-9][0-9]{0,9}$
getQuantity(): string setQuantity(string quantity): void
description ?string Optional This field supports up to 4000 characters, but any content beyond 2048 characters (including spaces) will be truncated. The 2048 character limit is reflected in the response representation of this field.

Constraints: Maximum Length: 4000
getDescription(): ?string setDescription(?string description): void
sku ?string Optional The stock keeping unit (SKU) for the item.

Constraints: Maximum Length: 127
getSku(): ?string setSku(?string sku): void
url ?string Optional The URL to the item being purchased. Visible to buyer and used in buyer experiences.

Constraints: Minimum Length: 1, Maximum Length: 2048
getUrl(): ?string setUrl(?string url): void
category ?string(ItemCategory) Optional The item category type.

Constraints: Minimum Length: 1, Maximum Length: 20
getCategory(): ?string setCategory(?string category): void
imageUrl ?string Optional The URL of the item's image. File type and size restrictions apply. An image that violates these restrictions will not be honored.

Constraints: Minimum Length: 1, Maximum Length: 2048, Pattern: ^(https:)([/|.|\w|\s|-])*\.(?:jpg|gif|png|jpeg|JPG|GIF|PNG|JPEG)
getImageUrl(): ?string setImageUrl(?string imageUrl): void
upc ?UniversalProductCode Optional The Universal Product Code of the item. getUpc(): ?UniversalProductCode setUpc(?UniversalProductCode upc): void
billingPlan ?OrderBillingPlan Optional Metadata for merchant-managed recurring billing plans. Valid only during the saved payment method token or billing agreement creation. getBillingPlan(): ?OrderBillingPlan setBillingPlan(?OrderBillingPlan billingPlan): void

Example (as JSON)

{
  "name": "name0",
  "unit_amount": {
    "currency_code": "currency_code2",
    "value": "value8"
  },
  "tax": {
    "currency_code": "currency_code0",
    "value": "value6"
  },
  "quantity": "quantity6",
  "description": "description0",
  "sku": "sku6",
  "url": "url4",
  "category": "DIGITAL_GOODS"
}