PayPal Connector Objects (REST Schema)

NameDescription
AuthorizationDetailsQuery details about Authorizations.
BalancesList all non crypto balances.
CaptureDetailsQuery details about a captured Payment.
CreditCardDetailsQuery details about the funding instrument of the payer, such as a Credit Card or a token that represents a Credit Card.
CryptoBalancesList all crypto balances.
DisputeDetailsPayPal merchants, partners, and external developers can use the PayPal Disputes API to manage disputes.
DisputesPayPal merchants, partners, and external developers can use the PayPal Disputes API to manage disputes.
DisputeTransactionsPayPal merchants, partners, and external developers can use the PayPal Disputes API to manage disputes.
InvoicesQuery Invoices in PayPal.
NotificationsQuery the list of event types that are subscribed to a Webhook.
OrderDetailsQuery details about an Order.
OrderItemsGet the items in an Order.
PaymentsQuery details about authorized Payments.
PaymentTokensLists merchant-created templates with associated details.
PaymentTransactionsQuery Transaction details including the amount and item details.
PayoutDetailsRetrieve details about Payouts.
PayoutItemsRetrieve payout items from a Payout.
PlansList the Billing Plans.
RefundDetailsQuery details about a specific Refund.
SaleDetailsQuery details about a Sale Transaction.
SubscriptionsGet billing and subscription details.
SubscriptionTransactionsLists transactions for a subscription.
TemplatesLists merchant-created templates with associated details.
TransactionReportsLists transaction reports.
TransactionReportsCartInfoItemDetailsList Cart Info of Transaction Reports.
TransactionReportsIncentiveDetailsList Incentive Details of Transaction Reports.
UserInfoShows OpenID Connect user profile information for standard claims.
WebhooksQuery the list of Webhooks.
NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe PayPal-generated ID for the authorized payment.
StatusStringFalseNoThe status for the authorized payment.
StatusDetailsStringFalseNoThe details of the authorized order pending status.
AmountTotalDecimalFalseNoThe amount for this authorized payment.
AmountCurrencyStringFalseNoThe currency of the amount.
InvoiceIdStringFalseNoThe API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives.
CustomIdStringFalseNoThe API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.
SellerProtectionStatusStringFalseNoThe level of protection offered as defined by PayPal Seller Protection for Merchants.
ExpirationTimeDatetimeFalseNoThe amount being charged for the handling fee. Only supported when the payment method is set to paypal.
CreateTimeDatetimeFalseNoThe time of authorization.
UpdateTimeDatetimeFalseNoThe time that the resource was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Currency [KEY]StringTrueNoCurrency Code of the balances listed.
AccountIdStringTrueNoThe PayPal payer ID, which is a masked version of the PayPal account number intended for use with third parties.
AvailableBalanceCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
AvailableBalanceValueStringTrueNoThe value, which might be an integer or a decimal.
PrimaryBooleanTrueNoOptional field representing if the currency is primary currency or not.
TotalBalanceCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
TotalBalanceValueDecimalTrueNoThe value, which might be integer or A decimal.
WithheldBalanceCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
WithheldBalanceValueStringTrueNoThe value, which might be integer or A decimal.
AsOfTimeDatetimeTrueNoThe requested date and time or the last date and time when the balances can be served.
LastRefreshTimeDatetimeTrueNoThe date and time when the balances was last refreshed.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe PayPal-generated ID for the captured payment.
StatusStringFalseNoThe status of the captured payment.
StatusDetailsStringFalseNoThe details of the captured payment status.
AmountValueDecimalFalseNoThe amount for this captured payment.
AmountCurrencyStringFalseNoThe currency of the amount for this captured payment.
InvoiceIdStringFalseNoThe API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives.
CustomIdStringFalseNoThe API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.
SellerProtectionStatusStringFalseNoThe level of protection offered as defined by PayPal Seller Protection for Merchants.
FinalCaptureBooleanFalseNoIndicates whether you can make additional captures against the authorized payment.
DisbursementModeStringFalseNoThe funds that are held on behalf of the merchant.
SellerGrossAmountDecimalFalseNoThe amount for this captured payment.
SellerPaypalFeeDecimalFalseNoThe applicable fee for this captured payment.
SellerNetAmountDecimalFalseNoThe net amount that the payee receives for this captured payment in their PayPal account.
SellerReceivableAmountDecimalFalseNoThe net amount that is credited to the payee's PayPal account. Returned only when the currency of the captured payment is different from the currency of the PayPal account where the payee wants to credit the funds.
SellerExchangeRateDecimalFalseNoThe exchange rate that determines the amount that is credited to the payee's PayPal account. Returned when the currency of the captured payment is different from the currency of the PayPal account where the payee wants to credit the funds.
CreateTimeDatetimeFalseNoThe time of authorization.
UpdateTimeDatetimeFalseNoThe time that the resource was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe Id of the credit card.
NumberStringFalseNoThe redacted credit card number.
TypeStringFalseNoThe credit card type. Valid types are: visa, mastercard, discover, amex.
ExpireMonthIntegerFalseNoThe expiration month with no leading zero. Acceptable values are 1 through 12.
ExpireYearIntegerFalseNoThe 4-digit expiration year.
FirstNameStringFalseNoThe first name of the cardholder.
LastNameStringFalseNoThe last name of the cardholder.
AddressLine1StringFalseNoThe billing address associated with card. Line 1 of the address (e.g., number, street, etc.).
AddressLine2StringFalseNoThe optional line 2 of the Address (e.g., suite, apt number, etc.).
CityStringFalseNoThe city name.
CountryCodeStringFalseNoThe 2-letter country code.
PostalCodeStringFalseNoThe ZIP code or equivalent is usually required for countries that have them.
PhoneStringFalseNoThe phone number in E.123 format.
ExternalCustomerIdStringFalseNoThe unique identifier of the customer to whom this bank account belongs. Generated and provided by the facilitator.
MerchantIdStringFalseNoThe user-provided, optional field that functions as a unique identifier for the merchant holding the card. Note that this has no relation to PayPal merchant Id.
ExternalCardIdStringFalseNoThe unique identifier of the bank account resource. Generated and provided by the facilitator so it can be used to restrict the usage of the bank account to the specific merchant.
CreateTimeDatetimeFalseNoThe resource creation time in ISO8601 date-time format (e.g., 1994-11-05T13:15:30Z).
UpdateTimeDatetimeFalseNoThe resource update time in ISO8601 date-time format (e.g., 1994-11-05T13:15:30Z).
StateStringFalseNoThe state of the credit card funding instrument: expired or ok.
ValidUntilDatetimeFalseNoThe funding instrument expiration date.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
AssetSymbol [KEY]StringTrueNoThe Cryptocurrency ticker symbol / code as assigned by liquidity providers.
AccountIdStringTrueNoThe PayPal payer ID, which is a masked version of the PayPal account number intended for use with third parties.
QuantityDecimalTrueNoQuantity of a cryptocurrency asset.
AsOfTimeDatetimeTrueNoThe requested date and time or the last date and time when the balances can be served.
LastRefreshTimeDatetimeTrueNoThe date and time when the balances were last refreshed.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DisputeId [KEY]StringFalseNoThe ID of the dispute.
CreatedTimeDatetimeFalseNoThe date and time when the dispute was created.
UpdatedTimeDatetimeFalseNoThe date and time when the dispute was updated.
StatusStringFalseNoThe status of the dispute.
ReasonStringFalseNoThe reason for the item-level dispute.
DisputeStateStringFalseNoThe state of the dispute.
DisputeCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
DisputeAmountValueDecimalFalseNoThe value of the amount.
ExternalReasonCodeStringFalseNoThe code that identifies the reason for the credit card chargeback.
DisputeOutcomeCodeStringFalseNoThe outcome of a resolved dispute.
DisputeOutcomeAmountRefundedCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
DisputeOutcomeAmountRefundedValueDecimalFalseNoThe value of the amount.
DisputeLifecycleStageStringFalseNoThe stage in the dispute lifecycle.
DisputeChannelStringFalseNoThe channel where the customer created the dispute.
OfferTypeStringFalseNoThe merchant-proposed offer type for the dispute.
BuyerRequestedAmountCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
BuyerRequestedAmountValueDecimalFalseNoThe value of the amount.
BuyerResponseDueDateDatetimeFalseNoThe date and time by when the customer must respond to the dispute.
SellerOfferedAmountCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
SellerOfferedAmountValueDecimalFalseNoThe value of the amount.
SellerResponseDueDateDatetimeFalseNoThe date and time by when the seller must respond to the dispute.
EmailStringFalseNoThe email address that is provided by the merchant where the customer can share the evidences.
NoteStringFalseNoThe merchant provided notes that are visible to both the customer and PayPal.
TimePostedDatetimeFalseNoThe date and time when the contact details were posted.
DisputeAssetSymbolStringFalseNoThe cryptocurrency symbol or code ticker options. Assigned by liquidity providers and exchanges.
DisputeAssetQuantityStringFalseNoThe quantity of a cryptocurrency asset.
DisputeAssetQuantityInSubunitsStringFalseNoThe quantity of a cryptocurrency asset in the currency's sub units.
DisputeOutcomeAssetRefundedSymbolStringFalseNoThe cryptocurrency symbol or code ticker options. Assigned by liquidity providers and exchanges.
DisputeOutcomeAssetRefundedQuantityDecimalFalseNoThe quantity of a cryptocurrency asset.
RefundAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
RefundAmountValueDecimalFalseNoThe maximum refundable amount.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DisputeId [KEY]StringFalseNoThe ID of the dispute.
CreatedTimeDatetimeFalseNoThe date and time when the dispute was created.
UpdatedTimeDatetimeFalseNoThe date and time when the dispute was updated.
StatusStringFalseNoThe status of the dispute.
ReasonStringFalseNoThe reason for the item-level dispute.
DisputeStateStringFalseNoThe state of the dispute.
DisputeCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
DisputeAmountValueDecimalFalseNoThe value of the amount.
DisputeLifecycleStageStringFalseNoThe stage in the dispute lifecycle.
DisputeChannelStringFalseNoThe channel where the customer created the dispute.
BuyerResponseDueDateDatetimeFalseNoThe date and time by when the customer must respond to the dispute.
SellerResponseDueDateDatetimeFalseNoThe date and time by when the seller must respond to the dispute.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
DisputeId [KEY]StringFalseNoThe ID of the dispute.
CreatedTimeDatetimeFalseNoThe date and time when the transaction was created.
TransactionStatusStringFalseNoThe transaction status.
GrossAmountCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
GrossAmountValueDecimalFalseNoThe value of the amount.
BuyerNameStringFalseNoThe customer's name.
BuyerTransactionIdStringFalseNoThe customer's transaction ID.
SellerEmailStringFalseNoThe email address for the merchant's PayPal account.
SellerMerchantIdStringFalseNoThe PayPal account ID for the merchant.
SellerTransactionIdStringFalseNoThe ID, as seen by the merchant, for this transaction.
SellerNameStringFalseNoThe name of the merchant.
SellerProtectionEligibleBooleanFalseNoIndicator if the seller is eligible for protection.
CustomStringFalseNoA free-text field that is entered by the merchant during checkout.
InvoiceNumberStringFalseNoThe ID of the invoice for the payment.
ReferenceIdStringFalseNoThe ID, as seen by the partner, for this transaction.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe ID of the invoice.
ParentIdStringFalseNoThe parent ID to an invoice that defines the group invoice to which the invoice is related.
StatusStringFalseNoThe status of the invoice.
ReferenceStringFalseNoThe reference data. Includes a post office (PO) number.
CurrencyStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
NoteStringFalseNoA note to the invoice recipient. Also appears on the invoice notification email.
TermsAndConditionsStringFalseNoThe general terms of the invoice. Can include return or cancellation policy and other terms and conditions.
MemoStringFalseNoA private bookkeeping memo for the user.
InvoiceDateDatetimeFalseNoThe invoice date as specificed by the sender, in Internet date and time format.
InvoiceNumberStringFalseNoA private bookkeeping memo for the user.
TermTypeStringFalseNoThe payment term. Payment can be due upon receipt, a specified date, or in a set number of days.
DueDateDatetimeFalseNoThe date when the invoice payment is due, in Internet date and time format.
DueAmountDecimalFalseNoThe due amount, which is the balance amount outstanding after payments.
GratuityDecimalFalseNoThe amount paid by the payer as gratuity to the invoicer.
PaidAmountDecimalFalseNoThe aggregated payment amounts against this invoice.
RefundAmountDecimalFalseNoThe aggregated refund amounts.
CreatedTimeDatetimeFalseNoThe date and time when the resource was created, in Internet date and time format.
CreatedByStringFalseNoThe email address of the account that created the resource.
LastUpdatedTimeDatetimeFalseNoThe date and time when the resource was last edited, in Internet date and time format.
LastUpdatedByStringFalseNoThe email address of the account that last edited the resource.
CancelTimeDatetimeFalseNoThe date and time when the resource was canceled, in Internet date and time format.
CancelledByStringFalseNoThe actor who canceled the resource.
FirstSentTimeDatetimeFalseNoThe date and time when the resource was first sent, in Internet date and time format.
LastSentTimeDatetimeFalseNoThe date and time when the resource was last sent, in Internet date and time format.
LastSentByStringFalseNoThe email address of the account that last sent the resource.
CreatedByFlowStringFalseNoThe flow variation that created this invoice.
RecipientViewUrlStringFalseNoThe URL for the invoice payer view hosted on paypal.com.
InvoicerViewUrlStringFalseNoThe URL for the invoice merchant view hosted on paypal.com.
InvoicerBusinessNameStringFalseNoThe business name of the party.
InvoicerPrefixNameStringFalseNoThe prefix, or title, to the party's name.
InvoicerFirstNameStringFalseNoWhen the party is a person, the party's given, or first, name.
InvoicerMiddleNameStringFalseNoWhen the party is a person, the party's middle name. Use also to store multiple middle names including the patronymic, or father's, middle name.
InvoicerLastNameStringFalseNoWhen the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person.
InvoicerSuffixNameStringFalseNoThe suffix for the party's name.
InvoicerFullNameStringFalseNoWhen the party is a person, the party's full name.
InvoicerAddressLine1StringFalseNoThe first line of the address. For example, number or street.
InvoicerAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
InvoicerAddressLine3StringFalseNoThe third line of the address, if needed.
InvoicerAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
InvoicerAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
InvoicerAddressStreetNumberStringFalseNoThe street number.
InvoicerAddressStreetNameStringFalseNoThe street name. Just Drury in Drury Lane.
InvoicerAddressStreetTypeStringFalseNoThe street type. For example, avenue, boulevard, road, or expressway.
InvoicerAddressDeliveryServiceStringFalseNoThe delivery service. Post office box, bag number, or post office name.
InvoicerAddressBuildingNameStringFalseNoA named locations that represents the premise. Usually a building name or number or collection of buildings with a common name or number.
InvoicerAddressSubBuildingStringFalseNoThe first-order entity below a named building or location that represents the sub-premise. Usually a single building within a collection of buildings with a common name.
InvoicerEmailStringFalseNoThe invoicer email address, which must be listed in the user's PayPal profile.
InvoicerWebsiteStringFalseNoThe invoicer's website.
InvoicerTaxIdStringFalseNoThe invoicer's tax ID.
InvoicerAdditionalNotesStringFalseNoAny additional information. Includes business hours.
InvoicerLogoUrlStringFalseNoThe full URL to an external logo image. The logo image must not be larger than 250 pixels wide by 90 pixels high.
TaxCalculatedAfterDiscountBooleanFalseNoIndicates whether the tax is calculated before or after a discount.
TaxInclusiveBooleanFalseNoIndicates whether the unit price includes tax.
AllowTipBooleanFalseNoIndicates whether the invoice enables the customer to enter a tip amount during payment.
TemplateIdStringFalseNoThe template ID. The template determines the layout of the invoice. Includes which fields to show and hide.
AllowPartialPaymentBooleanFalseNoIndicates whether the invoice allows a partial payment. If false, the invoice must be paid in full. If true, the invoice allows partial payments.
MinimumAmountDueStringFalseNoThe minimum amount allowed for a partial payment. Valid only when allow_partial_payment is true.
InvoiceAmountDecimalFalseNoThe invoice amount summary of item total, discount, tax total and shipping.
InvoiceCurrencyStringFalseNoThe invoice amount summary of item total, discount, tax total and shipping.
ItemTotalDecimalFalseNoThe subtotal for all items. Must equal the sum of (quantity * price) for all items.
InvoiceDiscountPercentageStringFalseNoThe discount as a percentage value. Value is from 0 to 100. Supports up to five decimal places.
InvoiceDiscountValueDecimalFalseNoThe invoice level discount amount. Value is from 0 to 1000000. Supports up to two decimal places.
ItemDiscountValueDecimalFalseNoThe discount as an amount at item level.
TaxTotalDecimalFalseNoThe aggregated amount of the item and shipping taxes.
ShippingAmountDecimalFalseNoThe shipping fee for all items. Includes tax on shipping.
ShippingTaxAmountDecimalFalseNoThe calculated tax amount. The tax amount is added to the item total.
ShippingTaxPercentageStringFalseNoThe tax rate. Value is from 0 to 100. Supports up to five decimal places.
ShippingTaxNameStringFalseNoThe name of the tax applied on the invoice items.
DueAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
GratuityCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
PaidAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
RefundAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
MinimumAmountDueCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
ItemTotalCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
InvoiceDiscountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
ItemDiscountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
ShippingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
ShippingTaxAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
NameStringFalseNoThe unique event type name.
DescriptionStringFalseNoThe human-readable description of the event type.
WebhookIdStringFalseNoWebhook Id.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe ID of the order.
StatusStringFalseNoThe order status. The possible values are: CREATED, SAVED, APPROVED, VOIDED, COMPLETED.
IntentStringFalseNoThe intent to either capture payment immediately or authorize a payment for an order after order creation. The possible values are: CAPTURE, AUTHORIZE.
CreatedTimeDatetimeFalseNoThe date and time when the transaction occurred.
UpdatedTimeDatetimeFalseNoThe date and time when the transaction was last updated.
PayerIdStringFalseNoThe ID of the customer who approves and pays for the order. The customer is also known as the payer.
PayerGivenNameStringFalseNoThe name of the customer who approves and pays for the order. The customer is also known as the payer.
PayerSurnameStringFalseNoThe last name of the customer who approves and pays for the order. The customer is also known as the payer.
PayerEmailStringFalseNoThe email of the customer who approves and pays for the order. The customer is also known as the payer.
PayerPhoneTypeStringFalseNoThe phone type.
PayerPhoneNumberStringFalseNoThe phone number, in its canonical international E.164 numbering plan format.
PayerBirthDateStringFalseNoThe birth date of the payer in YYYY-MM-DD format.
PayerTaxIdStringFalseNoThe customer's tax ID. Supported for the PayPal payment method only.
PayerTaxTypeStringFalseNoThe customer's tax ID type. Supported for the PayPal payment method only.
PayerAddressLine1StringFalseNoThe first line of the address. For example, number or street.
PayerAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PayerAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
PayerAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PayerAddressAdminArea1StringFalseNoThe highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
PayerAddressAdminArea2StringFalseNoA city, town, or village.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
OrderIdStringFalseNoThe ID of the Order this Item belongs to.
IdStringFalseNoThe PayPal-generated ID for the purchase unit. This ID appears in both the payer's transaction history and the emails that the payer receives.
ReferenceIdStringFalseNoThe API caller-provided external ID for the purchase unit. Required for multiple purchase units when you must update the order through PATCH.
AmountStringFalseNoThe total order amount with an optional breakdown that provides details, such as the total item amount, total tax amount, shipping, handling, insurance, and discounts, if any.
DescriptionStringFalseNoThe purchase description.
CustomIdStringFalseNoThe API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.
InvoiceIdStringFalseNoThe API caller-provided external invoice ID for this order.
SoftDescriptorStringFalseNoThe payment descriptor on account transactions on the customer's credit card statement.
ShipperFullNameStringFalseNoWhen the party is a person, the party's full name.
ShippingAddressLine1StringFalseNoThe first line of the address. For example, number or street.
ShippingAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
ShippingAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
ShippingAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PayeeEmailStringFalseNoThe email address of merchant.
PayeeMerchantIdStringFalseNoThe encrypted PayPal account ID of the merchant.
DisbursementModeStringFalseNoThe funds that are held on behalf of the merchant.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe PayPal-generated ID for the authorized payment.
IntentStringFalseNoThe payment intent.
PayerPaymentMethodStringFalseNoThe payment method.
PayerStatusStringFalseNoThe status of payer's PayPal account.
PayerEmailStringFalseNoThe payer's email address.
PayerSalutationStringFalseNoThe payer's salutation.
PayerFirstNameStringFalseNoThe payer's first name.
PayerMiddleNameStringFalseNoThe payer's middle name.
PayerLastNameStringFalseNoThe payer's last name.
PayerSuffixStringFalseNoThe payer's suffix.
PayerIdStringFalseNoThe PayPal-assigned encrypted payer ID.
PayerBirthDateDateFalseNoThe birth date of the payer, in Internet date format.
PayerTaxIdStringFalseNoThe payer's tax ID. Supported for the PayPal payment method only.
PayerTaxTypeStringFalseNoThe payer's tax ID type. Supported for the PayPal payment method only.
PayerBillingAddressLine1StringFalseNoThe first line of the address. For example, number, street, and so on.
PayerBillingAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PayerBillingAddressCityStringFalseNoThe city name.
PayerBillingAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PayerBillingAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent.
PayerBillingAddressStateStringFalseNoThe code for a US state or the equivalent for other countries.
PayerBillingAddressPhoneStringFalseNoThe phone number, in E.123 format.
PayerBillingAddressNormalizationStatusStringFalseNoThe address normalization status. Returned only for payers from Brazil.
PayerBillingAddressTypeStringFalseNoThe type of address. For example, HOME_OR_WORK, GIFT, and so on.
PayerShippingAddressLine1StringFalseNoThe first line of the address. For example, number, street, and so on.
PayerShippingAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PayerShippingAddressCityStringFalseNoThe city name.
PayerShippingAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PayerShippingAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent.
PayerShippingAddressStateStringFalseNoThe code for a US state or the equivalent for other countries.
PayerShippingAddressPhoneStringFalseNoThe phone number, in E.123 format.
PayerShippingAddressNormalizationStatusStringFalseNoThe address normalization status. Returned only for payers from Brazil.
PayerShippingAddressTypeStringFalseNoThe type of address. For example, HOME_OR_WORK, GIFT, and so on.
StateStringFalseNoThe state of the payment, authorization, or order transaction.
ExperienceProfileIdStringFalseNoThe PayPal-generated ID for the merchant's payment experience profile. For information, see create web experience profile.
NoteToPayerStringFalseNoA free-form field that clients can use to send a note to the payer.
FailureReasonStringFalseNoThe reason code for a payment failure.
ReturnUrlStringFalseNoThe URL where the payer is redirected after he or she approves the payment. Required for PayPal account payments.
CancelUrlStringFalseNoThe URL where the payer is redirected after he or she cancels the payment. Required for PayPal account payments.
BrandNameStringFalseNoA label that overrides the business name in the merchant's PayPal account on the PayPal checkout pages.
LocaleStringFalseNoThe locale of pages that the PayPal payment experience displays.
LandingPageStringFalseNoThe type of landing page to show on the PayPal site for customer checkout.
ShippingPreferenceStringFalseNoThe shipping preference.
UserActionStringFalseNoThe user action. Presents the customer with either the Continue or Pay Now checkout flow.
CreatedTimeDatetimeFalseNoThe date and time when the transaction occurred.
UpdatedTimeDatetimeFalseNoThe date and time when the payment was updated, in Internet date and time format.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe PayPal-generated ID for the vault token.
CustomerIdStringFalseNoThe unique ID for a customer in merchant's or partner's system of records.
MerchantCustomerIdStringFalseNoMerchants and partners may already have a data-store where their customer information is persisted. Use merchant_customer_id to associate the PayPal-generated customer.id to your representation of a customer.
PaymentSourceCardNameStringFalseNoThe card holder's name as it appears on the card.
PaymentSourceCardLastDigitsStringFalseNoThe last digits of the payment card.
PaymentSourceCardVerificationNetworkTransactionIdStringFalseNoTransaction Identifier as given by the network to indicate a previously executed CIT authorization.
PaymentSourceCardVerificationDateDatetimeFalseNoThe date that the transaction was authorized by the scheme.
PaymentSourceCardVerificationNetworkStringFalseNoName of the card network through which the transaction was routed.
PaymentSourceCardVerificationTimeStringFalseNoThe date and time when the instrument was verified.
PaymentSourceCardVerificationAmountValueDecimalFalseNoThe amount used for card verification.
PaymentSourceCardVerificationAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
PaymentSourceCardVerificationProcessorResponseAvsCodeStringFalseNoThe address verification code for Visa, Discover, Mastercard, or American Express transactions.
PaymentSourceCardVerificationProcessorResponseCvvCodeStringFalseNoThe card verification value code for for Visa, Discover, Mastercard, or American Express.
PaymentSourceCardNetworkTransactionReferenceIdStringFalseNoTransaction reference id returned by the scheme.
PaymentSourceCardNetworkTransactionReferenceDateDatetimeFalseNoThe date that the transaction was authorized by the scheme.
PaymentSourceCardNetworkTransactionReferenceNetworkStringFalseNoName of the card network through which the transaction was routed.
PaymentSourceCardNetworkTransactionReferenceTimeDatetimeFalseNoThe date and time when the instrument was verified.
PaymentSourceCardBrandStringFalseNoThe card brand or network. Typically used in the response.
PaymentSourceCardExpiryStringFalseNoThe card expiration year and month.
PaymentSourceCardAddressLine1StringFalseNoThe first line of the address. For example, number or street.
PaymentSourceCardAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PaymentSourceCardAddressAdminArea1StringFalseNoThe highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
PaymentSourceCardAddressAdminArea2StringFalseNoA city, town, or village.
PaymentSourceCardAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
PaymentSourceCardAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PaymentSourceCardAddressIdStringFalseNoThe resource ID of the address.
PaymentSourceCardAddressCompanyStringFalseNoThe name of the company or business associated to the address.
PaymentSourceCardAddressPhoneStringFalseNoThe phone number that can go on the mailing label with the address to track the shipping.
PaymentSourceCardAddressGivenNameStringFalseNoWhen the party is a person, the party's given, or first, name.
PaymentSourceCardAddressNameSurnameStringFalseNoWhen the party is a person, the party's surname or family name.
PaymentSourceCardAddressPhoneNumberStringFalseNoThe national number.
PaymentSourceCardAddressPhoneNumberCountryCodeStringFalseNoThe country calling code (CC), in its canonical international
PaymentSourceCardVerificationStatusStringFalseNoCard verification status
PaymentSourceCardTypeStringFalseNoThe payment card type.
PaymentSourcePaypalEmailAddressStringFalseNoThe email address of the payer.
PaymentSourcePaypalPayerIdStringFalseNoThe PayPal-assigned ID for the payer.
PaymentSourcePaypalGivenNameStringFalseNoWhen the party is a person, the party's given, or first, name.
PaymentSourcePaypalNameSurnameStringFalseNoWhen the party is a person, the party's surname or family name.
PaymentSourcePaypalPhoneNumberStringFalseNoThe national number.
PaymentSourcePaypalPhoneTypeStringFalseNoThe phone type.
PaymentSourcePaypalAddressLine1StringFalseNoThe first line of the address. For example, number or street.
PaymentSourcePaypalAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PaymentSourcePaypalAddressAdminArea1StringFalseNoThe highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
PaymentSourcePaypalAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
PaymentSourcePaypalAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PaymentSourcePaypalAccountIdStringFalseNoThe account identifier for a PayPal account.
PaymentSourceVenmoEmailAddressStringFalseNoThe email address of the payer.
PaymentSourceVenmoPayerIdStringFalseNoThe PayPal-assigned ID for the payer.
PaymentSourceVenmoGivenNameStringFalseNoWhen the party is a person, the party's given, or first, name.
PaymentSourceVenmoNameSurnameStringFalseNoWhen the party is a person, the party's surname or family name.
PaymentSourceVenmoPhoneNumberStringFalseNoThe national number.
PaymentSourceVenmoPhoneTypeStringFalseNoThe phone type.
PaymentSourceVenmoAddressLine1StringFalseNoThe first line of the address. For example, number or street.
PaymentSourceVenmoAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PaymentSourceVenmoAddressAdminArea1StringFalseNoThe highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
PaymentSourceVenmoAddressAdminArea2StringFalseNoA city, town, or village.
PaymentSourceVenmoAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
PaymentSourceVenmoAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PaymentSourceVenmoUserNameStringFalseNoThe Venmo username, as chosen by the user.
PaymentSourceApplePayNameStringFalseNoThe card holder's name as it appears on the card.
PaymentSourceApplePayLastDigitsStringFalseNoThe last digits of the payment card.
PaymentSourceApplePayTypeStringFalseNoThe payment card type.
PaymentSourceApplePayBrandStringFalseNoThe card brand or network.
PaymentSourceApplePayAddressLine1StringFalseNoThe first line of the address. For example, number or street.
PaymentSourceApplePayAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PaymentSourceApplePayAddressAdminArea1StringFalseNoThe highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
PaymentSourceApplePayAddressAdminArea2StringFalseNoA city, town, or village.
PaymentSourceApplePayAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
PaymentSourceApplePayAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PaymentIdStringFalsePayments.IdNoThe Id of the payment.
AmountDecimalFalseNoThe amount to collect.
CurrencyStringFalseNoThe currency of the amount to collect.
PayeeEmailStringFalseNoThe email address associated with the payee's PayPal account.
PayeeMerchantIdStringFalseNoThe PayPal account ID for the payee.
DescriptionStringFalseNoThe purchase description.
NoteToPayeeStringFalseNoThe note to the recipient of the funds in this transaction.
CustomStringFalseNoThe free-form field for the client's use.
InvoiceNumberStringFalseNoThe invoice number to track this payment.
SoftDescriptorStringFalseNoThe soft descriptor to use to charge this funding source. If greater than the maximum allowed length, the API truncates the string.
NotifyUrlStringFalseNoThe URL to send payment notifications.
AllowedPaymentMethodStringFalseNoThe payment method for this transaction. This field does not apply to the credit card payment method.
RecipientNameStringFalseNoThe name of the recipient.
ShippingPhoneNumberStringFalseNoThe shipping phone number, in its canonical international format as defined by the E.164 numbering plan.
ShippingAddressLine1StringFalseNoThe first line of the address. For example, number, street, and so on.
ShippingAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
ShippingAddressCityStringFalseNoThe city name.
ShippingAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
ShippingAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent.
ShippingAddressStateStringFalseNoThe code for a US state or the equivalent for other countries.
ShippingAddressPhoneStringFalseNoThe phone number, in E.123 format.
ShippingAddressNormalizationStatusStringFalseNoThe address normalization status. Returned only for payers from Brazil.
ShippingAddressTypeStringFalseNoThe type of address. For example, HOME_OR_WORK, GIFT, and so on.
ShippingMethodStringFalseNoThe shipping method used for this payment, such as USPS Parcel.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PayoutBatchId [KEY]StringFalseNoThe ID of the payout for which to show details.
BatchStatusStringFalseNoThe PayPal-generated payout status. If the payout passes preliminary checks, the status is PENDING.
TimeCreatedDatetimeFalseNoThe date and time when processing for the payout began
TimeCompletedDatetimeFalseNoThe date and time when processing for the payout completed.
SenderBatchIdStringFalseNoThe sender-specified ID number. Tracks the payout in an accounting system.
SenderEmailSubjectStringFalseNoThe subject line for the email that PayPal sends when payment for a payout item completes. The subject line is the same for all recipients.
AmountDecimalFalseNoThe total amount,requested for the payouts.
CurrencyStringFalseNoThe currency of the total amount
FeeAmountDecimalFalseNoThe amount of the total estimate for the applicable payouts fees. Initially, the fee is 0. The fee is populated after the payout moves to the PROCESSING state.
FeeCurrencyStringFalseNoThe currency for the applicable payouts fees.
TimeClosedDatetimeFalseNoThe date and time when the payout was closed, in Internet date and time format.
SenderEmailMessageStringFalseNoThe email message that PayPal sends when the payout item completes. The message is the same for all recipients.
SenderEmailRecipientTypeStringFalseNoThe ID type that identifies the payment receiver.
FundingSourceStringFalseNoThe ID to differentiate a PayPal balance-funded transaction from a PayPal treasury-funded transaction.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
PayoutBatchId [KEY]StringFalseNoThe ID of the payout for which to show payout items details.
PayoutItemId [KEY]StringFalseNoThe ID for the payout item
TransactionIdStringFalseNoThe PayPal-generated ID for the transaction.
TransactionStatusStringFalseNoThe transaction status.
FeeAmountDecimalFalseNoThe amount for the applicable payout fee. Initially, the fee is 0. The fee is populated after the item moves to the PENDING state
FeeCurrencyStringFalseNoThe currency for the applicable payout fee
RecipientTypeStringFalseNoThe recipient type.Value is: EMAIL, PHONE, PAYPAL_ID.
AmountValueDecimalFalseNoThe amount of payout item.
AmountCurrencyStringFalseNoThe currency of payout item.
NoteStringFalseNoA sender-specified note for notifications.
ReceiverStringFalseNoThe receiver of the payment. Corresponds to the recipient_type value in the request.
SenderItemIdStringFalseNoA sender-specified ID number. Tracks the payout in an accounting system.
TimeProcessedDatetimeFalseNoThe date and time when this item was last processed.
ErrorsMessageStringFalseNoThe message that describes the error, if any.
ErrorsNameStringFalseNoThe human-readable, unique name of the error, if any.
ErrorsDebugIdStringFalseNoThe PayPal internal ID. Used for correlation purposes.
ErrorsInformationLinkStringFalseNoThe information link, or URI, that shows detailed information about this error for the developer.
ActivityIdStringFalseNoThe unique PayPal-generated common ID that links the sender- and receiver-side transactions. Used for tracking.
SenderBatchIdStringFalseNoA sender-specified ID. Tracks the payout in an accounting system.
RecipientNamePrefixStringFalseNoThe prefix, or title, to the party's name.
RecipientGivenNameStringFalseNoWhen the party is a person, the party's given, or first, name.
RecipientSurnameStringFalseNoWhen the party is a person, the party's surname or family name. Also known as the last name.
RecipientMiddleNameStringFalseNoWhen the party is a person, the party's middle name.
RecipientFullNameStringFalseNoWhen the party is a person, the party's full name.
RecipientWalletStringFalseNoThe recipient wallet.
PurposeStringFalseNoThe purpose of the transaction.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe unique PayPal-generated ID for the plan.
CreateTimeDatetimeFalseNoThe date and time when the plan was created
DescriptionStringFalseNoThe detailed description of the plan.
BillingCyclesVersionIntegerFalseNoThe active pricing scheme for this billing cycle.
BillingCyclesPricingModelStringFalseNoThe active pricing scheme for this billing cycle.
BillingCyclesFrequencyStringFalseNoThe frequency details for this billing cycle.
BillingCyclesTenureTypeStringFalseNoThe tenure type of the billing cycle.
BillingCyclesSequenceIntegerFalseNoThe order in which this cycle is to run among other billing cycles.
BillingCyclesTotalCyclesIntegerFalseNoThe number of times this billing cycle gets executed.
LinksStringFalseNocontains the link of plan object
NameStringFalseNoThe plan name.
ProductIdStringFalseNoThe ID for the product.
QuantitySupportedBooleanFalseNoIndicates whether you can subscribe to this plan by providing a quantity for the goods or service..
StatusStringFalseNoThe plan status.
TaxesInclusiveBooleanFalseNoIndicates whether the tax was already included in the billing amount.
TaxesPercentageStringFalseNoThe tax percentage on the billing amount.
UpdateTimeDatetimeFalseNoThe date and time when the plan was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe PayPal-generated ID for the captured payment.
StatusStringFalseNoThe status of the captured payment.
StatusDetailsStringFalseNoThe details of the captured payment status.
AmountValueDecimalFalseNoThe amount for this captured payment.
AmountCurrencyStringFalseNoThe currency of the amount for this captured payment.
InvoiceIdStringFalseNoThe API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives.
NoteToPayerStringFalseNoThe reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives.
SellerGrossAmountDecimalFalseNoThe amount for this captured payment.
SellerPaypalFeeDecimalFalseNoThe applicable fee for this captured payment.
SellerNetAmountDecimalFalseNoThe net amount that the payee receives for this captured payment in their PayPal account.
TotalRefundedMoneyDecimalFalseNoThe total amount refunded from the original capture to date.
CreateTimeDatetimeFalseNoThe time of authorization.
UpdateTimeDatetimeFalseNoThe time that the resource was last updated.
CustomIdStringFalseNoThe API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions.
AcquirerReferenceNumberStringFalseNoReference ID issued for the card transaction.
PayerEmailAddressStringFalseNoThe email address of merchant.
PayerMerchantIdStringFalseNoThe encrypted PayPal account ID of the merchant.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe Id of the sale transaction.
StateStringFalseNoThe state of the sale. One of the following: pending, completed, refunded, or partially_refunded.
CurrencyStringFalseNoThe 3-letter currency code.
SubtotalDecimalFalseNoThe amount of the subtotal of the items.
TaxAmountDecimalFalseNoThe amount charged for tax.
ShippingAmountDecimalFalseNoThe amount charged for shipping.
ShippingDiscountDecimalFalseNoThe amount being discounted for the shipping fee. Only supported when the payment method is set to paypal.
HandlingFeeAmountDecimalFalseNoThe amount being charged for the handling fee. Only supported when the payment method is set to paypal.
InsuranceAmountDecimalFalseNoThe amount being charged for the insurance fee. Only supported when the payment method is set to paypal.
TotalAmountDecimalFalseNoThe total amount charged from the payer to the payee. In case of a refund, this is the refunded amount to the original payer from the payee.
ClearingTimeDatetimeFalseNoThe expected clearing time for e-check transactions. Only supported when the payment method is set to paypal.
CreateTimeDatetimeFalseNoThe time of sale.
DescriptionStringFalseNoThe description of the sale.
ExchangeRateStringFalseNoThe exchange rate applied for this transaction. Returned only in cross-currency use cases where a merchant bills a buyer in a non-primary currency for that buyer.
FmfDescriptionStringFalseNoThe description of the filter.
FmfFilterIdStringFalseNoThe name of the fraud management filter. One of the following: MAXIMUM_TRANSACTION_AMOUNT (basic filter), UNCONFIRMED_ADDRESS (basic filter), COUNTRY_MONITOR (basic filter), AVS_NO_MATCH (address verification service no match -- advanced filter), AVS_PARTIAL_MATCH (address verification service partial match -- advanced filter), AVS_UNAVAILABLE_OR_UNSUPPORTED (address verification service unavailable or not supported -- advanced filter), CARD_SECURITY_CODE_MISMATCH (advanced filter), BILLING_OR_SHIPPING_ADDRESS_MISMATCH (advanced filter), RISKY_ZIP_CODE (high risk lists filter), SUSPECTED_FREIGHT_FORWARDER_CHECK (high risk lists filter), RISKY_EMAIL_ADDRESS_DOMAIN_CHECK (high risk lists filter), RISKY_BANK_IDENTIFICATION_NUMBER_CHECK (high risk lists filter), RISKY_IP_ADDRESS_RANGE (high risk lists filter), LARGE_ORDER_NUMBER (transaction data filter), TOTAL_PURCHASE_PRICE_MINIMUM (transaction data filter), IP_ADDRESS_VELOCITY (transaction data filter), and PAYPAL_FRAUD_MODEL (transaction data filter).
FmfFilterTypeStringFalseNoThe type of the fraud management filter. One of the following: ACCEPT (an ACCEPT filter is triggered only for the TOTAL_PURCHASE_PRICE_MINIMUM filter setting and is returned only in direct credit card payments where payment is accepted), PENDING (triggers a PENDING filter action where you need to explicitly accept or deny the transaction), DENY (triggers a DENY action where payment is denied automatically), and REPORT (triggers the Flag testing mode where payment is accepted).
FmfNameStringFalseNoThe name of the filter.
ParentPaymentStringFalseNoThe Id of the payment resource on which this transaction is based.
PaymentModeStringFalseNoThe payment mode of the transaction. Only supported when the payment method is set to paypal. One of the following: INSTANT_TRANSFER, MANUAL_BANK_TRANSFER, DELAYED_TRANSFER, or ECHECK.
PendingReasonStringFalseNoThe reason the transaction is in a pending state. Only supported when the payment method is set to paypal. One of the following: PAYER-SHIPPING-UNCONFIRMED, MULTI-CURRENCY, RISK-REVIEW, REGULATORY-REVIEW, VERIFICATION-REQUIRED , ORDER, or OTHER.
ProtectionEligibilityStringFalseNoThe level of seller protection in force for the transaction. Only supported when the payment method is set to paypal. One of the following: ELIGIBLE, PARTIALLY_ELIGIBLE, INELIGIBLE.
ProtectionEligibilityTypeStringFalseNoThe kind of seller protection in force for the transaction. This property is returned only when the ProtectionEligibility property is set to ELIGIBLE or PARTIALLY_ELIGIBLE. Only supported when the payment method is set to paypal. One of the following: ITEM_NOT_RECEIVED_ELIGIBLE or UNAUTHORIZED_PAYMENT_ELIGIBLE. One or both of the allowed values can be returned.
ReasonCodeStringFalseNoThe reason code for the transaction state being Pending or Reversed. Only supported when the payment method is set to paypal. One of the following: CHARGEBACK, GUARANTEE, BUYER_COMPLAINT, REFUND, UNCONFIRMED_SHIPPING_ADDRESS, ECHECK, INTERNATIONAL_WITHDRAWAL, RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION, PAYMENT_REVIEW, REGULATORY_REVIEW, UNILATERAL, or VERIFICATION_REQUIRED.
ReceiptIdStringFalseNoThe 16-digit number payment identification number returned for guest users to identify the payment.
ReceivableAmountDecimalFalseNoThe receivable amount.
TransactionFeeDecimalFalseNoThe transaction fee.
UpdateTimeDatetimeFalseNoThe time that the sale was last updated.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe PayPal-generated ID for the subscription.
BillingInfocycle_executionsStringFalseNoThe trial and regular billing executions.
BillingInfo_FailedPaymentsCountIntegerFalseNoThe Failed payments count.
BillingInfo_LastPaymentAmountCurrencyCodeStringFalseNoThe last payment amount currency code.
BillingInfo_LastPaymentAmountValueStringFalseNoThe last payment amount.
BillingInfo_LastPaymentTimeDatetimeFalseNoThe date and time when the last payment was made.
BillingInfo_NextBillingTimeDatetimeFalseNoThe next date and time for billing this subscription.
BillingInfo_OutstandingBalanceCurrencyCodeStringFalseNoThe total pending bill amount, to be paid by the subscriber.
BillingInfo_outstandingBalanceValueStringFalseNoThe total pending bill amount, to be paid by the subscriber.
CreateTimeDatetimeFalseNoThe date and time of subscription created.
LinksStringFalseNoLinks for the subscription objects.
PlanIdStringFalseNoThe ID of the plan.
QuantityIntegerFalseNoThe quantity of the product in the subscription.
ShippingAmountCurrencyCodeStringFalseNoThe currency for a financial transaction, such as a balance or payment due.
ShippingAmountValueStringFalseNoThe amount for a financial transaction, such as a balance or payment due.
StartTimeDatetimeFalseNoThe start date and time of the subscription.
StatusStringFalseNoThe status of the subscription.
StatusUpdateTimeDatetimeFalseNoThe date and time of status updated.
SubscriberEmailAddressStringFalseNoThe email address of the payer.
SubscriberName_GivenNameStringFalseNoThe given name of the payer.
SubscriberName_SurnameStringFalseNoThe sur name of the payer.
SubscriberPayerIdStringFalseNoThe PayPal-assigned ID for the payer.
SubscriberShippingAddress_AddressAddressLine1StringFalseNoPrimary address of the payer.
SubscriberShippingAddress_AddressAddressLine2StringFalseNoSecondary address of the payer.
SubscriberShippingAddress_AddressAdminArea1StringFalseNoPrimary address of the payer.
SubscriberShippingAddress_AddressAdminArea2StringFalseNoSecondary address of the payer.
SubscriberShippingAddress_AddressCountryCodeStringFalseNoCountry code of the payer address.
SubscriberShippingAddress_AddressPostalCodeStringFalseNoPostal code of the payer address.
SubscriberShippingAddress_NameFullNameStringFalseNoFull name of the Payer.
UpdateTimeDatetimeFalseNoThe date and time of subscription updated.
SubscriberShippingAddress_TypeStringFalseNoThe method by which the payer wants to get their items from the payee e.g shipping, in-person pickup.
SubscriberPhoneTypeStringFalseNoThe phone type.
SubscriberPhoneNumberStringFalseNoThe phone number, in its canonical international E.164 numbering plan format.
StatusChangeNoteStringFalseNoThe reason or notes for the status of the subscription.
CustomIdStringFalseNoThe custom id for the subscription. Can be invoice id.
PlanOverriddenBooleanFalseNoIndicates whether the subscription has overridden any plan attributes.
BillingInfo_LastPaymentStatusStringFalseNoThe status of the captured payment.
BillingInfo_FinalPaymentTimeDatetimeFalseNoThe date and time when the final billing cycle occurs, in Internet date and time format.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
SubscriptionIdStringFalseSubscriptions.IdNoThe ID of the subscription.
AmountWithBreakdown_FeeAmountCurrencyCodeStringFalseNoThe fee details for the transaction.
AmountWithBreakdown_FeeAmountValueStringFalseNoThe fee details for the transaction.
AmountWithBreakdown_GrossAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
AmountWithBreakdown_GrossAmountValueStringFalseNoThe value of the currency.
AmountWithBreakdown_NetAmountCurrencyCodeStringFalseNoThe currency code of the net amount that the payee receives for this transaction in their PayPal account.
AmountWithBreakdown_NetAmountValueStringFalseNoThe net amount that the payee receives for this transaction in their PayPal account.
PayerEmailStringFalseNoThe email ID of the customer.
PayerNameGivenNameStringFalseNoWhen the party is a person, the party's given, or first, name.
PayerNameSurnameStringFalseNoWhen the party is a person, the party's surname or family name. Also known as the last name.
StatusStringFalseNoThe initial state of the plan.
TimeDatetimeFalseNoThe date and time when the transaction was processed.
AmountWithBreakdown_TotalItemAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
AmountWithBreakdown_TotalItemAmountValueDecimalFalseNoThe item total for the transaction.
AmountWithBreakdown_ShippingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
AmountWithBreakdown_ShippingAmountValueDecimalFalseNoThe shipping amount for the transaction.
AmountWithBreakdown_TaxAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
AmountWithBreakdown_TaxAmountValueDecimalFalseNoThe tax amount for the transaction.
StartTimeDatetimeFalseYesThe start time of the range of transactions to list.
EndTimeDatetimeFalseYesThe end time of the range of transactions to list.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe ID of the template.
NameStringFalseNoThe template name.
DefaultTemplateBooleanFalseNoIndicates whether this template is the default template.
StandardTemplateBooleanFalseNoIndicates whether this template is a invoicer-created custom template. The system generates non-custom templates.
LinksStringFalseNoAn array of request-related HATEOAS links.
TemplateInfoDetailReferenceStringFalseNoThe reference data. Includes a Purchase Order (PO) number.
TemplateInfoDetailNoteStringFalseNoA note to the invoice recipient. Also appears on the invoice notification email.
TemplateInfoDetailTermsAndConditionsStringFalseNoThe general terms of the invoice. Can include return or cancellation policy and other terms and conditions.
TemplateInfoDetailMemoStringFalseNoA private bookkeeping memo for the user.
TemplateInfoDetailCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoDetailPaymentTermTypeStringFalseNoThe payment term. Payment can be due upon receipt, a specified date, or in a set number of days.
TemplateInfoMetadataCreatedByStringFalseNoThe email address of the account that created the resource.
TemplateInfoMetadataLastUpdatedByStringFalseNoThe email address of the account that last edited the resource.
TemplateInfoMetadataCreateTimeDatetimeFalseNoThe date and time, in Internet date and time format.
TemplateInfoMetadataLastUpdateTimeDatetimeFalseNoThe date and time, in Internet date and time format.
TemplateInfoInvoicerBusinessNameStringFalseNoThe business name of the party.
TemplateInfoInvoicerPrefixNameStringFalseNoThe prefix, or title, to the party's name.
TemplateInfoInvoicerFirstNameStringFalseNoWhen the party is a person, the party's given, or first, name.
TemplateInfoInvoicerMiddleNameStringFalseNoWhen the party is a person, the party's middle name. Use also to store multiple middle names including the patronymic, or father's, middle name.
TemplateInfoInvoicerLastNameStringFalseNoWhen the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person.
TemplateInfoInvoicerSuffixNameStringFalseNoThe suffix for the party's name.
TemplateInfoInvoicerFullNameStringFalseNoWhen the party is a person, the party's full name.
TemplateInfoInvoicerAddressLine1StringFalseNoThe first line of the address. For example, number or street.
TemplateInfoInvoicerAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
TemplateInfoInvoicerAddressLine3StringFalseNoThe third line of the address, if needed.
TemplateInfoInvoicerAddressAdminArea1StringFalseNoThe highest level sub-division in a country, which is usually a province, state, or ISO-3166-2 subdivision.
TemplateInfoInvoicerAddressAdminArea2StringFalseNoA city, town, or village.
TemplateInfoInvoicerAddressAdminArea3StringFalseNoA sub-locality, suburb, neighborhood, or district.
TemplateInfoInvoicerAddressAdminArea4StringFalseNoThe neighborhood, ward, or district.
TemplateInfoInvoicerAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent. Typically required for countries with a postal code or an equivalent.
TemplateInfoInvoicerAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
TemplateInfoInvoicerAddressStreetNumberStringFalseNoThe street number.
TemplateInfoInvoicerAddressStreetNameStringFalseNoThe street name. Just Drury in Drury Lane.
TemplateInfoInvoicerAddressStreetTypeStringFalseNoThe street type. For example, avenue, boulevard, road, or expressway.
TemplateInfoInvoicerAddressDeliveryServiceStringFalseNoThe delivery service. Post office box, bag number, or post office name.
TemplateInfoInvoicerAddressBuildingNameStringFalseNoA named locations that represents the premise. Usually a building name or number or collection of buildings with a common name or number.
TemplateInfoInvoicerAddressSubBuildingStringFalseNoThe first-order entity below a named building or location that represents the sub-premise. Usually a single building within a collection of buildings with a common name.
TemplateInfoInvoicerPhonesStringFalseNoAn array of invoicer's phone numbers. The invoicer can choose to hide the phone number on the invoice.
TemplateInfoInvoicerWebsiteStringFalseNoThe invoicer's website.
TemplateInfoInvoicerTaxIdStringFalseNoThe invoicer's tax ID.
TemplateInfoInvoicerAdditionalNotesStringFalseNoAny additional information. Includes business hours.
TemplateInfoInvoicerLogoUrlStringFalseNoThe full URL to an external logo image. The logo image must not be larger than 250 pixels wide by 90 pixels high.
TemplateInfoInvoicerEmailStringFalseNoThe invoicer email address, which must be listed in the user's PayPal profile.
TemplateInfoConfigurationTaxCalculatedAfterDiscountBooleanFalseNoIndicates whether the tax is calculated before or after a discount.
TemplateInfoConfigurationTaxInclusiveBooleanFalseNoIndicates whether the unit price includes tax.
TemplateInfoConfigurationAllowTipBooleanFalseNoIndicates whether the invoice enables the customer to enter a tip amount during payment.
TemplateInfoConfigurationAllowPartialPaymentBooleanFalseNoIndicates whether the invoice allows a partial payment. If false, the invoice must be paid in full. If true, the invoice allows partial payments.
TemplateInfoConfigurationMinimumAmountDueDecimalFalseNoThe minimum amount allowed for a partial payment. Valid only when allow_partial_payment is true.
TemplateInfoConfigurationMinimumAmountDueCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountValueDecimalFalseNoThe invoice amount summary of item total, discount, tax total and shipping.
TemplateInfoAmountCurrencyCodeStringFalseNoThe invoice amount summary of item total, discount, tax total and shipping.
TemplateInfoAmountBreakdownItemTotalValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TemplateInfoAmountBreakdownItemTotalCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountBreakdownInvoiceDiscountPercentageDecimalFalseNoThe discount as a percentage value. Value is from 0 to 100.
TemplateInfoAmountBreakdownInvoiceDiscountValueDecimalFalseNoThe invoice level discount amount.
TemplateInfoAmountBreakdownInvoiceDiscountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountBreakdownItemDiscountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TemplateInfoAmountBreakdownItemDiscountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountBreakdownTaxTotalValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TemplateInfoAmountBreakdownTaxTotalCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountBreakdownShippingAmountValueDecimalFalseNoThe shipping fee for all items. Includes tax on shipping.
TemplateInfoAmountBreakdownShippingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountBreakdownShippingTaxAmountValueDecimalFalseNoThe calculated tax amount. The tax amount is added to the item total.
TemplateInfoAmountBreakdownShippingTaxAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoAmountBreakdownShippingTaxPercentageDecimalFalseNoThe tax rate.
TemplateInfoAmountBreakdownShippingTaxNameStringFalseNoThe name of the tax applied on the invoice items.
TemplateInfoAmountBreakdownShippingTaxNoteStringFalseNoThe tax note used to track the tax related data.
TemplateInfoAmountBreakdownCustomLabelStringFalseNoThe label to the custom amount of the invoice.
TemplateInfoAmountBreakdownCustomAmountValueDecimalFalseNoThe custom amount to apply to an invoice.
TemplateInfoAmountBreakdownCustomAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TemplateInfoDueAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TemplateInfoDueAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
ItemSettingsStringFalseNoThe template item headers display preference.
SubtotalSettingsStringFalseNoThe template subtotal headers display preference.
UnitOfMeasureStringFalseNoThe unit of measure for the invoiced item.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
AccountNumberStringTrueNoThe merchant account number.
LastRefreshedDatetimeDatetimeTrueNoThe date and time when the data was last refreshed, in Internet date and time format.
AuctionInfoAuctionBuyerIdStringFalseNoThe ID of the buyer who makes the purchase in the auction.
AuctionInfoAuctionClosingDateDatetimeFalseNoThe date and time when the auction closes.
AuctionInfoAuctionItemSiteStringFalseNoThe auction site URL.
AuctionInfoAuctionSiteStringFalseNoThe name of the auction site.
PayerInfoAccountIdStringFalseNoThe PayPal customer account ID.
PayerInfoAddressStatusStringFalseNoThe address status of the payer.
PayerInfoCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region of the payer.
PayerInfoEmailAddressStringFalseNoThe email address of the payer.
PayerInfoPayerNameAlternateFullNameStringFalseNoThe party's alternate name.
PayerInfoPayerNameGivenNameStringFalseNoWhen the party is a person, the party's given, or first, name.
PayerInfoPayerNameSurnameStringFalseNoWhen the party is a person, the party's surname or family name. Also known as the last name. Required when the party is a person. Use also to store multiple surnames including the matronymic, or mother's, surname.
PayerInfoPayerStatusStringFalseNoThe status of the payer. Value is Y or N.
ShippingInfoAddressCityStringFalseNoThe city name.
ShippingInfoAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
ShippingInfoAddressLine1StringFalseNoThe first line of the address. For example, number or street.
ShippingInfoAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
ShippingInfoAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent.
ShippingInfoNameStringFalseNoThe recipient's name.
StoreInfoStoreIdStringFalseNoThe ID of a store for a merchant in the system of record.
StoreInfoTerminalIdStringFalseNoThe terminal ID for the checkout stand in a merchant store.
TransactionInfoCustomFieldStringFalseNoThe merchant-provided custom text.
TransactionInfoFeeAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoFeeAmountValueStringFalseNoThe value of fee.
TransactionInfoInsuranceAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoInsuranceAmountValueStringFalseNoThe value of insurance amount.
TransactionInfoInvoiceIdStringFalseNoThe invoice ID that is sent by the merchant with the transaction.
TransactionInfoPaypalAccountIdStringFalseNoThe ID of the PayPal account of the counterparty.
TransactionInfoProtectionEligibilityStringFalseNoIndicates whether the transaction is eligible for protection.
TransactionInfoShippingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoShippingAmountValueStringFalseNoThe value of shipping amount.
TransactionInfoShippingDiscountAmountCurrency_codeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoShippingDiscountAmountValueStringFalseNoThe value of shipping discount amount.
TransactionInfoTransactionAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoTransactionAmountValueStringFalseNoThe value of transaction amount.
TransactionInfoTransactionEventCodeStringFalseNoA five-digit transaction event code that classifies the transaction type based on money movement and debit or credit.
TransactionInfoTransactionIdStringFalseNoThe PayPal-generated transaction ID.
TransactionInfoTransactionInitiationDateDatetimeFalseNoThe date and time when work on a transaction began in the PayPal system, as expressed in the time zone of the account on this side of the payment.
TransactionInfoTransactionNoteStringFalseNoA special note that the payer passes to the payee. Might contain special customer requests, such as shipping instructions.
TransactionInfoTransactionStatusStringFalseNoA code that indicates the transaction status.
TransactionInfoTransactionSubjectStringFalseNoThe subject of payment. The payer passes this value to the payee. The payer controls this data through the interface through which he or she sends the data.
TransactionInfoTransactionUpdatedDateDatetimeFalseNoThe date and time when the transaction was last changed, as expressed in the time zone of the account on this side of the payment.
TransactionInfoAnnualPercentageRateDecimalFalseNoThe percentage, as a fixed-point, signed decimal number.
PayerInfoAddressLine1StringFalseNoThe first line of the address. For example, number or street.
PayerInfoAddressLine2StringFalseNoThe second line of the address. For example, suite or apartment number.
PayerInfoAddressCityStringFalseNoThe city name.
PayerInfoAddressStateStringFalseNoThe code for a US state or the equivalent for other countries.
PayerInfoAddressCountryCodeStringFalseNoThe two-character ISO 3166-1 code that identifies the country or region.
PayerInfoAddressPostalCodeStringFalseNoThe postal code, which is the zip code or equivalent.
ShippingInfoAddressStateStringFalseNoThe code for a US state or the equivalent for other countries.
ShippingInfoMethodStringFalseNoThe shipping method that is associated with this order.
TransactionInfoPaypalReferenceIdStringFalseNoThe PayPal-generated base ID. PayPal exclusive.
TransactionInfoPaypalReferenceIdTypeStringFalseNoThe PayPal reference ID type.
TransactionInfoPaymentTrackingIdStringFalseNoThe payment tracking ID, which is a unique ID that partners specify to either get information about a payment or request a refund.
TransactionInfoBankReferenceIdStringFalseNoThe bank reference ID.
TransactionInfoCreditTermStringFalseNoThe credit term.
TransactionInfoPaymentMethodTypeStringFalseNoThe payment method that was used for a transaction. Value is PUI, installment, or mEFT.
TransactionInfoInstrumentTypeStringFalseNoA high-level classification of the type of financial instrument that was used to fund a payment. The pattern is not provided because the value is defined by an external party.
TransactionInfoInstrumentSubTypeStringFalseNoA finer-grained classification of the financial instrument that was used to fund a payment.
TransactionInfoDiscountAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoDiscountAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoSalesTaxAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoSalesTaxAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoShippingTaxAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoShippingTaxAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoOtherAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoOtherAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoTipAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoTipAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoEndingBalanceCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoEndingBalanceValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoAvailableBalanceCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoAvailableBalanceValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoCreditTransactionalFeeCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoCreditTransactionalFeeValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TransactionInfoCreditPromotionalFeeCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
TransactionInfoCreditPromotionalFeeValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
StartDateDatetimeFalseYesThe start date and time, in Internet date and time format.
EndDateDatetimeFalseYesThe end date and time, in Internet date and time format.
TransactionIdStringFalseYesThe PayPal-generated transaction ID.
PaymentInstrumentTypeStringFalseYesFilters the transactions in the response by a payment instrument type.
BalanceAffectingRecordsOnlyStringFalseYesIndicates whether the response includes only balance-impacting transactions or all transactions.
StoreIdStringFalseYesFilters the transactions in the response by a store ID.
TerminalIdStringFalseYesFilters the transactions in the response by a terminal ID.
TransactionAmountStringFalseYesFilters the transactions in the response by a gross transaction amount range. For example, to search for transactions from $5.00 to $10.05, specify [500 TO 1005].
TransactionCurrencyStringFalseYesFilters the transactions in the response by a three-character ISO-4217 currency code for the PayPal transaction currency.
TransactionStatusStringFalseYesFilters the transactions in the response by a PayPal transaction status code.
TransactionTypeStringFalseYesFilters the transactions in the response by a PayPal transaction event code.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
AccountNumberStringTrueNoThe merchant account number.
LastRefreshedDatetimeDatetimeTrueNoThe date and time when the data was last refreshed, in Internet date and time format.
InvoiceNumberStringTrueNoThe invoice number. An alphanumeric string that identifies a billing for a merchant.
ItemAmountCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
ItemAmountValueStringTrueNoThe value of item amount.
ItemCodeStringTrueNoAn item code that identifies a merchant's goods or service.
ItemDescriptionStringTrueNoThe item description.
ItemNameStringTrueNoThe item name.
ItemQuantityStringTrueNoThe number of purchased units of goods or a service.
ItemUnitPriceCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
ItemUnitPriceValueStringTrueNoThe value of item unit price.
TaxAmountsStringTrueNoAn array of tax amounts levied by a government on the purchase of goods or services.
TotalItemAmountCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
TotalItemAmountValueStringTrueNoThe value of total item amount.
DiscountAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
DiscountAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
AdjustmentAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
AdjustmentAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
GiftWrapAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
GiftWrapAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
TaxPercentageDecimalFalseNoThe percentage, as a fixed-point, signed decimal number.
BasicShippingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
BasicShippingAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
ExtraShippingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
ExtraShippingAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
HandlingAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
HandlingAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
InsuranceAmountCurrencyCodeStringFalseNoThe three-character ISO-4217 currency code that identifies the currency.
InsuranceAmountValueDecimalFalseNoThe amount for a financial transaction, such as a balance or payment due.
ItemOptionsStringTrueNoThe item options. Describes option choices on the purchase of the item in some detail.
StartDateDatetimeFalseYesThe start date and time, in Internet date and time format.
EndDateDatetimeFalseYesThe end date and time, in Internet date and time format.
TransactionIdStringFalseYesThe PayPal-generated transaction ID.
PaymentInstrumentTypeStringFalseYesFilters the transactions in the response by a payment instrument type.
BalanceAffectingRecordsOnlyStringFalseYesIndicates whether the response includes only balance-impacting transactions or all transactions.
StoreIdStringFalseYesFilters the transactions in the response by a store ID.
TerminalIdStringFalseYesFilters the transactions in the response by a terminal ID.
TransactionAmountStringFalseYesFilters the transactions in the response by a gross transaction amount range. For example, to search for transactions from $5.00 to $10.05, specify [500 TO 1005].
TransactionCurrencyStringFalseYesFilters the transactions in the response by a three-character ISO-4217 currency code for the PayPal transaction currency.
TransactionStatusStringFalseYesFilters the transactions in the response by a PayPal transaction status code.
TransactionTypeStringFalseYesFilters the transactions in the response by a PayPal transaction event code.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
AccountNumberStringTrueNoThe merchant account number.
LastRefreshedDatetimeDatetimeTrueNoThe date and time when the data was last refreshed, in Internet date and time format.
IncentiveAmountCurrencyCodeStringTrueNoThe three-character ISO-4217 currency code that identifies the currency.
IncentiveAmountValueStringTrueNoThe value of incentive amount.
IncentiveCodeStringTrueNoThe code that identifies an incentive, such as a coupon.
IncentiveProgramCodeStringTrueNoThe incentive program code that identifies a merchant loyalty or incentive program.
IncentiveTypeStringTrueNoThe type of incentive, such as a special offer or coupon.
StartDateDatetimeFalseYesThe start date and time, in Internet date and time format.
EndDateDatetimeFalseYesThe end date and time, in Internet date and time format.
TransactionIdStringFalseYesThe PayPal-generated transaction ID.
PaymentInstrumentTypeStringFalseYesFilters the transactions in the response by a payment instrument type.
BalanceAffectingRecordsOnlyStringFalseYesIndicates whether the response includes only balance-impacting transactions or all transactions.
StoreIdStringFalseYesFilters the transactions in the response by a store ID.
TerminalIdStringFalseYesFilters the transactions in the response by a terminal ID.
TransactionAmountStringFalseYesFilters the transactions in the response by a gross transaction amount range. For example, to search for transactions from $5.00 to $10.05, specify [500 TO 1005].
TransactionCurrencyStringFalseYesFilters the transactions in the response by a three-character ISO-4217 currency code for the PayPal transaction currency.
TransactionStatusStringFalseYesFilters the transactions in the response by a PayPal transaction status code.
TransactionTypeStringFalseYesFilters the transactions in the response by a PayPal transaction event code.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
UserIdStringFalseNoThe user ID of the user.
SubStringFalseNoThe subject ID for the end user at the issuer.
NameStringFalseNoThe full name of the user.
GivenNameStringFalseNoThe given, or first, name of the user.
FamilyNameStringFalseNoThe surname or family name of the user. Also known as the last name.
MiddleNameStringFalseNoThe middle name of the user.
PictureStringFalseNoThe URL of the profile picture of the user.
EmailStringFalseNoThe internationalized email address.
EmailVerifiedBooleanFalseNoIndicates whether the user's email address is verified.
GenderStringFalseNoThe user's gender.
BirthdateDatetimeFalseNoThe user's birthday, in YYYY-MM-DD format.
ZoneInfoStringFalseNoThe time zone of the user.
LocaleStringFalseNoThe locale of the user.
PhoneNumberStringFalseNoThe preferred telephone number of the user.
StreetAddressStringFalseNoThe full street address. Can include the house number and street name.
LocalityStringFalseNoThe city or locality.
RegionStringFalseNoThe state, province, prefecture, or region.
PostalCodeStringFalseNoThe zip code or postal code.
CountryStringFalseNoThe country.
VerifiedAccountBooleanFalseNoIndicates whether the account is verified.
AccountTypeStringFalseNoThe account type.
AgeRangeStringFalseNoThe account holder's age range.

Return to Top

NameTypeReadOnlyReferencesFilterOnlyDescription
Id [KEY]StringFalseNoThe identifier of the webhook resource.
UrlStringFalseNoThe webhook notification endpoint URL.

Return to Top