Business Platforms and marketplacesPlatforms Enterprise

Business Platforms and marketplaces Enterprise

Sections

Business Platforms and marketplaces Enterprise

Help

FAQs Account help Technical support API Status

APIs & SDKs

JavaScript SDK React SDK REST API Server SDKs Codes Webhook events iOS Android

Duplicate Transaction

The duplicate transaction details.

received_duplicatebooleanOptional

If `true`, indicates that a duplicate transaction was received.

original_transactionobject<transaction_info>Optional

The transaction details for the original transaction, when the dispute reason is `DUPLICATE_TRANSACTION`. Currently, contains only the date and amount.

transaction_info properties

13 properties

buyer_transaction_idstringOptional

The ID, as seen by the customer, for this transaction.

Match^[A-Za-z0-9-]+$Length1 <= length <= 255

seller_transaction_idstringOptional

The ID, as seen by the merchant, for this transaction.

Match^[A-Za-z0-9-]+$Length1 <= length <= 255

reference_idstringOptional

The ID, as seen by the partner, for this transaction.

Match^.*$Length1 <= length <= 255

create_timestring<date_time>Optional

The date and time when the transaction was created, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). For example, *`yyyy`*-*`MM`*-*`dd`*`T`*`HH`*:*`mm`*:*`ss`*.*`SSS`*`Z`.

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Formatppaas_date_time_v3Length20 <= length <= 64

transaction_statusenumOptional

The transaction status.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"COMPLETED"
"UNCLAIMED"
"DENIED"
"FAILED"
"HELD"
"PENDING"
"PARTIALLY_REFUNDED"
"REFUNDED"
"REVERSED"
"CANCELLED"

gross_amountobject<money>Optional

The gross amount of the transaction.

money properties

2 properties

currency_codestring<currency_code>Required

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

Formatppaas_common_currency_code_v2Length3 <= length <= 3

valuestringRequired

The value, which might be:

An integer for currencies like `JPY` that are not typically fractional.
A decimal fraction for currencies like `TND` that are subdivided into thousandths.

For the required number of decimal places for a currency code, see [Currency Codes](/api/rest/reference/currency-codes/).

Match^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$Length0 <= length <= 32

gross_assetobject<cryptocurrency>Optional

The gross asset of the transaction.

cryptocurrency properties

4 properties

asset_symbolenum<cryptocurrency_symbol>Required

The cryptocurrency symbol or code ticker options. Assigned by liquidity providers and exchanges.

Match^[0-9A-Za-z]{1,10}$Length1 <= length <= 10

Allowed values

"BTC"
"ETH"
"BCH"
"LTC"
"PYUSD"
"LINK"
"SOL"
"MATIC"

quantitystring<cryptocurrency_quantity>Required

The quantity of a cryptocurrency asset. This is a decimal number with a scale defined for each cryptocurrency by its founders. For example, Bitcoin (BTC) has 8 as its scale, Ethereum (ETH) has 18 as its scale. The PayPal Cryptocurrency platform handles the scale to 8 digits for Bitcoin. including its forks or offshoots, as well as Ethereum.

Match^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$Length1 <= length <= 40

quantity_in_subunitsstring<cryptocurrency_subunits_quantity>Optional

The quantity of a cryptocurrency asset in the currency's sub units.
Amount is an integer in a string format.
Floating point should be avoided to avoid precision errors. For example:

Bitcoin(BTC) has 8 decimals,

so 1 BTC will be represented as 100000000 (1 followed by 8 zeroes).

Ethereum(ETH) has 18 decimals,

so 1 ETH will be represented as 1000000000000000000 (1 followed by 18 zeroes).

Match^-?[0-9]+$Length1 <= length <= 81

decimalsinteger<cryptocurrency_decimals>Optional

The number of decimal digits supported by this cryptocurrency. For example, for Bitcoin this value is 8 because there are 10^8 satoshis in one Bitcoin and for Ethereum it's 18 since there are 10^18 wei in one Ether.

Range0 <= value <= 40

invoice_numberstringOptional

The ID of the invoice for the payment.

Match^[A-Za-z0-9:\-|]+$Length1 <= length <= 127

customstringOptional

A free-text field that is entered by the merchant during checkout.

Match^(.|\r?\n)*$Length1 <= length <= 2000

buyerobject<buyer>Optional

The details for the customer who funds the payment. For example, the customer's first name, last name, and email address.

buyer properties

1 property

namestringOptional

The customer's name.

Match^[^~!@#$%^*()_{}:|\t\n/]+$Length1 <= length <= 2000

sellerobject<seller>Optional

The details for the merchant who receives the funds and fulfills the order. For example, merchant ID, and contact email address.

seller properties

3 properties

emailstring<email_address>Optional

The email address for the merchant's PayPal account.

Match^(?:[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?\.)+[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[A-Za-z0-9-]*[A-Za-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$Formatppaas_common_email_address_v2Length3 <= length <= 254

merchant_idstringOptional

The PayPal account ID for the merchant.

Match^[0-9A-Za-z]+$Length1 <= length <= 255

namestringOptional

The name of the merchant.

Match^[^~!@#$%^*()_{}:|\t\n/]+$Length1 <= length <= 2000

itemsobject<item_info>[]Optional

An array of items that were purchased as part of the transaction.

Items1 <= length <= 100

item_info properties

15 properties

item_idstringOptional

The item ID. If the merchant provides multiple pieces of evidence and the transaction has multiple item IDs, the merchant can use this value to associate a piece of evidence with an item ID.

Match^.*$Length1 <= length <= 255

item_namestringOptional

The item name.

Match^.*$Length1 <= length <= 2000

item_descriptionstringOptional

The item description.

Match^(.|\r?\n)*$Length1 <= length <= 2000

item_quantitystringOptional

The count of the item in the dispute. Must be a whole number.

Match^[1-9][0-9]{0,9}$Length1 <= length <= 10

partner_transaction_idstringOptional

The ID of the transaction in the partner system. The partner transaction ID is returned at an item level because the partner might show different transactions for different items in the cart.

Match^[A-Za-z0-9]+$Length1 <= length <= 255

reasonenum<dispute_reason>Optional

The reason for the item-level dispute. For information about the required information for each dispute reason and associated evidence type, see dispute reasons.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"MERCHANDISE_OR_SERVICE_NOT_RECEIVED"
"MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED"
"UNAUTHORISED"
"CREDIT_NOT_PROCESSED"
"DUPLICATE_TRANSACTION"
"INCORRECT_AMOUNT"
"PAYMENT_BY_OTHER_MEANS"
"CANCELED_RECURRING_BILLING"
"PROBLEM_WITH_REMITTANCE"
"OTHER"

dispute_amountobject<money>Optional

The amount of the item in the dispute.

money properties

2 properties

currency_codestring<currency_code>Required

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

Formatppaas_common_currency_code_v2Length3 <= length <= 3

valuestringRequired

The value, which might be:

An integer for currencies like `JPY` that are not typically fractional.
A decimal fraction for currencies like `TND` that are subdivided into thousandths.

For the required number of decimal places for a currency code, see [Currency Codes](/api/rest/reference/currency-codes/).

Match^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$Length0 <= length <= 32

notesstringOptional

Any notes provided with the item.

Match^(.|\r?\n)*$Length1 <= length <= 2000

item_typeenum<item_type>Optional

The type of the item which has the issue.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"PRODUCT"
"SERVICE"
"BOOKING"
"DIGITAL_DOWNLOAD"

product_detailsitem_product_detailsOptional

service_detailsitem_service_detailsOptional

booking_detailsitem_booking_detailsOptional

digital_download_detailsitem_digital_download_detailsOptional

cancellation_detailsitem_cancellation_detailsOptional

agreed_refund_detailsitem_agreed_refund_detailsOptional

payment_processorpayment_processorOptional

Back to top

Duplicate Transaction

The duplicate transaction details.

received_duplicatebooleanOptional

If `true`, indicates that a duplicate transaction was received.

original_transactionobject<transaction_info>Optional

The transaction details for the original transaction, when the dispute reason is `DUPLICATE_TRANSACTION`. Currently, contains only the date and amount.

transaction_info properties

13 properties

buyer_transaction_idstringOptional

The ID, as seen by the customer, for this transaction.

Match^[A-Za-z0-9-]+$Length1 <= length <= 255

seller_transaction_idstringOptional

The ID, as seen by the merchant, for this transaction.

Match^[A-Za-z0-9-]+$Length1 <= length <= 255

reference_idstringOptional

The ID, as seen by the partner, for this transaction.

Match^.*$Length1 <= length <= 255

create_timestring<date_time>Optional

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Formatppaas_date_time_v3Length20 <= length <= 64

transaction_statusenumOptional

The transaction status.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"COMPLETED"
"UNCLAIMED"
"DENIED"
"FAILED"
"HELD"
"PENDING"
"PARTIALLY_REFUNDED"
"REFUNDED"
"REVERSED"
"CANCELLED"

gross_amountobject<money>Optional

The gross amount of the transaction.

money properties

2 properties

currency_codestring<currency_code>Required

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

Formatppaas_common_currency_code_v2Length3 <= length <= 3

valuestringRequired

The value, which might be:

An integer for currencies like `JPY` that are not typically fractional.
A decimal fraction for currencies like `TND` that are subdivided into thousandths.

For the required number of decimal places for a currency code, see [Currency Codes](/api/rest/reference/currency-codes/).

Match^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$Length0 <= length <= 32

gross_assetobject<cryptocurrency>Optional

The gross asset of the transaction.

cryptocurrency properties

4 properties

asset_symbolenum<cryptocurrency_symbol>Required

The cryptocurrency symbol or code ticker options. Assigned by liquidity providers and exchanges.

Match^[0-9A-Za-z]{1,10}$Length1 <= length <= 10

Allowed values

"BTC"
"ETH"
"BCH"
"LTC"
"PYUSD"
"LINK"
"SOL"
"MATIC"

quantitystring<cryptocurrency_quantity>Required

Match^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$Length1 <= length <= 40

quantity_in_subunitsstring<cryptocurrency_subunits_quantity>Optional

The quantity of a cryptocurrency asset in the currency's sub units.
Amount is an integer in a string format.
Floating point should be avoided to avoid precision errors. For example:

Bitcoin(BTC) has 8 decimals,

so 1 BTC will be represented as 100000000 (1 followed by 8 zeroes).

Ethereum(ETH) has 18 decimals,

so 1 ETH will be represented as 1000000000000000000 (1 followed by 18 zeroes).

Match^-?[0-9]+$Length1 <= length <= 81

decimalsinteger<cryptocurrency_decimals>Optional

Range0 <= value <= 40

invoice_numberstringOptional

The ID of the invoice for the payment.

Match^[A-Za-z0-9:\-|]+$Length1 <= length <= 127

customstringOptional

A free-text field that is entered by the merchant during checkout.

Match^(.|\r?\n)*$Length1 <= length <= 2000

buyerobject<buyer>Optional

The details for the customer who funds the payment. For example, the customer's first name, last name, and email address.

buyer properties

1 property

namestringOptional

The customer's name.

Match^[^~!@#$%^*()_{}:|\t\n/]+$Length1 <= length <= 2000

sellerobject<seller>Optional

The details for the merchant who receives the funds and fulfills the order. For example, merchant ID, and contact email address.

seller properties

3 properties

emailstring<email_address>Optional

The email address for the merchant's PayPal account.

merchant_idstringOptional

The PayPal account ID for the merchant.

Match^[0-9A-Za-z]+$Length1 <= length <= 255

namestringOptional

The name of the merchant.

Match^[^~!@#$%^*()_{}:|\t\n/]+$Length1 <= length <= 2000

itemsobject<item_info>[]Optional

An array of items that were purchased as part of the transaction.

Items1 <= length <= 100

item_info properties

15 properties

item_idstringOptional

The item ID. If the merchant provides multiple pieces of evidence and the transaction has multiple item IDs, the merchant can use this value to associate a piece of evidence with an item ID.

Match^.*$Length1 <= length <= 255

item_namestringOptional

The item name.

Match^.*$Length1 <= length <= 2000

item_descriptionstringOptional

The item description.

Match^(.|\r?\n)*$Length1 <= length <= 2000

item_quantitystringOptional

The count of the item in the dispute. Must be a whole number.

Match^[1-9][0-9]{0,9}$Length1 <= length <= 10

partner_transaction_idstringOptional

The ID of the transaction in the partner system. The partner transaction ID is returned at an item level because the partner might show different transactions for different items in the cart.

Match^[A-Za-z0-9]+$Length1 <= length <= 255

reasonenum<dispute_reason>Optional

The reason for the item-level dispute. For information about the required information for each dispute reason and associated evidence type, see dispute reasons.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"MERCHANDISE_OR_SERVICE_NOT_RECEIVED"
"MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED"
"UNAUTHORISED"
"CREDIT_NOT_PROCESSED"
"DUPLICATE_TRANSACTION"
"INCORRECT_AMOUNT"
"PAYMENT_BY_OTHER_MEANS"
"CANCELED_RECURRING_BILLING"
"PROBLEM_WITH_REMITTANCE"
"OTHER"

dispute_amountobject<money>Optional

The amount of the item in the dispute.

money properties

2 properties

currency_codestring<currency_code>Required

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

Formatppaas_common_currency_code_v2Length3 <= length <= 3

valuestringRequired

The value, which might be:

An integer for currencies like `JPY` that are not typically fractional.
A decimal fraction for currencies like `TND` that are subdivided into thousandths.

For the required number of decimal places for a currency code, see [Currency Codes](/api/rest/reference/currency-codes/).

Match^((-?[0-9]+)|(-?([0-9]+)?[.][0-9]+))$Length0 <= length <= 32

notesstringOptional

Any notes provided with the item.

Match^(.|\r?\n)*$Length1 <= length <= 2000

item_typeenum<item_type>Optional

The type of the item which has the issue.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"PRODUCT"
"SERVICE"
"BOOKING"
"DIGITAL_DOWNLOAD"

product_detailsitem_product_detailsOptional

service_detailsitem_service_detailsOptional

booking_detailsitem_booking_detailsOptional

digital_download_detailsitem_digital_download_detailsOptional

cancellation_detailsitem_cancellation_detailsOptional

agreed_refund_detailsitem_agreed_refund_detailsOptional

payment_processorpayment_processorOptional

Duplicate Transaction

transaction_info properties

money properties

cryptocurrency properties

buyer properties

seller properties

item_info properties

money properties

Back to top

On this page

On this page

Duplicate Transaction

transaction_info properties

money properties

cryptocurrency properties

buyer properties

seller properties

item_info properties

money properties

Back to top

On this page

Duplicate Transaction

transaction_info properties

money properties

cryptocurrency properties

buyer properties

seller properties

item_info properties

money properties

Back to top

On this page

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

Duplicate Transaction

transaction_info properties

money properties

cryptocurrency properties

buyer properties

seller properties

item_info properties

money properties

Back to top

On this page