Payment Execution

The subtotal amount for the items. If the request includes line items, this property is **required**. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Note: For an order authorization or capture, you cannot include the subtotal parameter.

The shipping fee. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Note: For an order authorization or capture, you cannot include the shipping parameter.

The tax. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Note: For an order authorization or capture, you cannot include the tax parameter.

The handling fee. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Supported for the PayPal payment method only.

Note: For an order authorization or capture, you cannot include the handling_fee parameter.

The shipping fee discount. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Supported for the PayPal payment method only.

Note: For an order authorization or capture, you cannot include the shipping_discount parameter.

The insurance fee. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Supported only for the PayPal payment method.

Note: For an order authorization or capture, you cannot include the insurance parameter.

The gift wrap fee. Maximum length is 10 characters, which includes:

• Seven digits before the decimal point.
• The decimal point.
• Two digits after the decimal point.

Note: For an order authorization or capture, you cannot include the gift_wrap parameter.

The stock keeping unit (SKU) for the item.

The item name. If this value is greater than the maximum allowed length, the API truncates the string.

The item description. Supported for only the PayPal payment method.

The item quantity. Must be a whole number.

The item cost. Supports two decimal places.

The [three-character ISO-4217 currency code](/docs/api/reference/currency-codes/) that identifies the currency.

The item tax. Supported only for the PayPal payment method.

The first line of the address. For example, number, street, and so on.

The second line of the address. For example, suite or apartment number.

The city name.

The [two-character ISO 3166-1 code](/docs/api/reference/country-codes/) that identifies the country or region.

Note: The country code for Great Britain is GB and not UK as used in the top-level domain names for that country. Use the `C2` country code for China worldwide for comparable uncontrolled price (CUP) method, bank card, and cross-border transactions.

The postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent. See [postal code](https://en.wikipedia.org/wiki/Postal_code).

The [code](/docs/integration/direct/rest/state-codes/) for a US state or the equivalent for other countries. Required for transactions if the address is in one of these countries: [Argentina](/docs/integration/direct/rest/state-codes/#argentina), [Brazil](/docs/integration/direct/rest/state-codes/#brazil), [Canada](/docs/integration/direct/rest/state-codes/#canada), [China](/docs/integration/direct/rest/state-codes/#china), [India](/docs/integration/direct/rest/state-codes/#india), [Italy](/docs/integration/direct/rest/state-codes/#italy), [Japan](/docs/integration/direct/rest/state-codes/#japan), [Mexico](/docs/integration/direct/rest/state-codes/#mexico), [Thailand](/docs/integration/direct/rest/state-codes/#thailand), or [United States](/docs/integration/direct/rest/state-codes/#usa).

The phone number, in [E.123 format](https://www.itu.int/rec/T-REC-E.123-200102-I/en). Maximum length is 50 characters.

The address normalization status. Returned only for payers from Brazil.

The type of address. For example, `HOME_OR_WORK`, `GIFT`, and so on.

The name of the recipient at this address.