Get a Cancellation Request
GET /post-order/v2/cancellation/{cancelId}
This method retrieves the details of a specific cancellation.
The response from this call depends on the value set for the fieldgroups query parameter. If the value of fieldgroups is set to SUMMARY
, the response payload is identical to the payload retrieved in the GET /post-order/v2/cancellation/search call. If you set the value of fieldgroups to FULL
, the response includes a history of each cancellation request and the list of each line item in the order.
Output Samples Change History |
Input
See also Samples.
Resource URI (production)
GET https://api.ebay.com/post-order/v2/cancellation/{cancelId}? fieldgroups=GetCancelFieldGroup
URI parameters
Parameter | Type | Required? | Meaning |
---|---|---|---|
cancelId | string | Required | Input the unique identifier for the cancel request you wish to retrieve. |
fieldgroups | string | Optional |
The value set in this query parameter controls the level of detail that is returned in the response. Applicable values:
FULL .
Applicable values are from GetCancelFieldGroup. |
HTTP request headers
All requests made to eBay REST operations require you to provide the authorization
HTTP header for authentication.
See HTTP request headers for details.
Authorization
This call uses standard authorization tokens. See Making a Call for details.
Payload model
This call has no request payload.
Input Samples Change History |
Output
See also Samples.
Payload model
Note: For information about the error fields and how to work with them, see Error Handling.
The following lists all fields that could be included in the response.
Supported response formats: application/json, application/xml
For more information:
- See GetCancelDetailResponse for a description of the response structure
- See the following table for descriptions of each of the data elements returned
- See the Samples for an example of the response format
{ /* GetCancelDetailResponse */ "cancelDetail": { /* CancelDetail */ "activityHistories": [ { /* CancelActivityHistory */ "actionDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "activityParty": token, "activityType": token, "stateFrom": token, "stateTo": token } /* More CancelActivityHistory nodes here */ ], "buyerLoginName": string, "buyerResponseDueDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "cancelCloseDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "cancelCloseReason": token, "cancelId": string, "cancelReason": token, "cancelRequestDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "cancelState": token, "cancelStatus": token, "legacyOrderId": string, "marketplaceId": token, "moneyMovementInfo": [ { /* can:MoneyMovementDetailType */ "actualAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "creationDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "moneyMovementType": token, "requestedAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "status": token } /* More can:MoneyMovementDetailType nodes here */ ], "partialOrderType": token, "paymentStatus": token, "payoutRecoupInfo": { /* PayoutRecoupInfo */ "amountToRecoup": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "payoutId": integer }, "refundInfo": { /* RefundInfo */ "actualRefundDetail": { /* ActualRefundDetail */ "actualRefund": { /* ActualRefund */ "feeCreditAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "totalAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number } }, "fundings": [ { /* RefundFundingType */ "amount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "date": { /* DateTime */ "formattedValue": string, "value": datetime }, "fundingSource": { /* FundingSourceType */ "brand": string, "memo": string, "type": string }, "fundingStatus": string } /* More RefundFundingType nodes here */ ], "netChargeAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "outstandingAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "refundIssuedDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "refundStatus": token } }, "requestorType": token, "requestRefundAmount": { /* Amount */ "convertedFromCurrency": string, "convertedFromValue": number, "currency": string, "exchangeRate": string, "value": number }, "sellerLoginName": string, "sellerResponseDueDate": { /* DateTime */ "formattedValue": string, "value": datetime }, "shipmentDate": { /* DateTime */ "formattedValue": string, "value": datetime } } }
Response field descriptions
Output Container/Field | Type | Occurrence | Meaning |
---|---|---|---|
cancelDetail | CancelDetail | Always |
Contains information about a canceled order. If the value of the fieldgroups query parameter is set to FULL , the response also contains a record of all activity performed on the cancellation request plus the identifiers for each line item in the order.
|
cancelDetail.activityHistories | array of CancelActivityHistory | Always | A complete list of the activity associated with this cancellation request. |
cancelDetail.activityHistories .actionDate |
DateTime | Always | The timestamp for the action that occurred with the cancellation request. |
cancelDetail.activityHistories .actionDate.formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.activityHistories .actionDate.value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.activityHistories .activityParty |
token | Always |
The party who performed the action on the cancellation request, either the buyer or the seller. Applicable values: See PartyEnum |
cancelDetail.activityHistories .activityType |
token | Always |
The type of event or action that occurred with the cancellation request. Applicable values: See CancelActivityTypeEnum |
cancelDetail.activityHistories .stateFrom |
token | Always |
Indicates the state of the cancellation request prior to the performed action (defined in the activityType field). Applicable values: See CancelStateEnum |
cancelDetail.activityHistories .stateTo |
token | Always |
The state of the cancellation process following this event or action. Depending on the activityType, the state of the cancellation process might not change, so in such cases this value can be the same as the value of stateFrom. Applicable values: See CancelStateEnum |
cancelDetail.buyerLoginName | string | Conditionally | The eBay-assigned username of the account that represents the buyer in the transaction. |
cancelDetail .buyerResponseDueDate |
DateTime | Conditionally | A timestamp that indicates the time by which the buyer is required to respond to an active cancellation request. This container is not returned if the cancellation request does not currently require a response from the buyer. |
cancelDetail .buyerResponseDueDate .formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail .buyerResponseDueDate.value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.cancelCloseDate | DateTime | Conditionally | A timestamp that indicates when the cancellation request was closed. This field is only applicable and returned when the cancellation request is closed (regardless of outcome). |
cancelDetail.cancelCloseDate .formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.cancelCloseDate .value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.cancelCloseReason | token | Conditionally |
The reason why the cancel request was closed. This field is only applicable and returned if the cancellation request was closed or if the buyer attempted to close the cancellation request. Applicable values: See CancelCloseReasonEnum |
cancelDetail.cancelId | string | Always | A unique eBay-assigned ID for an order cancellation. All data in the cancelDetail container refers to this specific order cancellation. |
cancelDetail.cancelReason | token | Conditionally |
The reason why the user (either the buyer or seller, as defined in the requestorType field) initiated the cancellation request. Applicable values: See CancelReasonEnum |
cancelDetail.cancelRequestDate | DateTime | Always | A timestamp that indicates when the cancellation request was created. |
cancelDetail.cancelRequestDate .formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.cancelRequestDate .value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.cancelState | token | Always |
The current stage or condition of the cancellation process. This value, combined with the value of the cancelStatus field, can help you determine upcoming cancellation events and the appropriate actions you can take. Applicable values: See CancelStateEnum |
cancelDetail.cancelStatus | token | Always |
The last action taken by one of the parties associated with the cancellation. This value, combined with the value of the cancelState field, can help you determine upcoming events and the appropriate actions you can take on the cancellation. Applicable values: See CancelStatusEnum |
cancelDetail.legacyOrderId | string | Always |
A unique eBay-assigned ID for the order being canceled or considered for cancellation. Note: The order ID value changes as an order goes from the unpaid to the paid state. |
cancelDetail.marketplaceId | token | Always |
A unique eBay-assigned ID for the eBay marketplace where the cancellation was created. Applicable values: See MarketplaceIdEnum |
cancelDetail.moneyMovementInfo | array of can:MoneyMovementDetailType | Conditionally |
This container consists of detailed information on a money movement transaction. A moneyMovementInfo container is returned for each separate money movement transaction. Note: If the seller's account is enabled with eBay managed payments, additional refund information for the cancelled order is shown in the refundInfo container. |
cancelDetail.moneyMovementInfo .actualAmount |
Amount | Conditionally | This dollar value is the actual amount of the monetary transaction. The actualAmount field will only show up if the monetary transaction was confirmed to be successful (moneyMovementStatusType values shows as 'SUCCESS'. Until then, expected amount of the monetary transaction can be seen in the requestedAmount field. |
cancelDetail.moneyMovementInfo .actualAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.moneyMovementInfo .actualAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.moneyMovementInfo .actualAmount.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.moneyMovementInfo .actualAmount.exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.moneyMovementInfo .actualAmount.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.moneyMovementInfo .creationDate |
DateTime | Conditionally | This timestamp indicates the date and time when the monetary transaction occurred. |
cancelDetail.moneyMovementInfo .creationDate.formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.moneyMovementInfo .creationDate.value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.moneyMovementInfo .moneyMovementType |
token | Always |
Indicates the type of monetary transaction that is either in the process of being executed or has already executed. Monetary transactions include a seller's partial or full refund to the buyer or the seller receiving the Final Value Fee refund from eBay. Applicable values: See can:MoneyMovementTypeEnum |
cancelDetail.moneyMovementInfo .requestedAmount |
Amount | Always |
This monetary amount is the expected value of the transaction. This field is returned regardless of the value shown in the moneyMovementStatusType field. The actualAmount field displays only when the monetary transaction was confirmed to be successful (moneyMovementStatusType equals SUCCESS .
|
cancelDetail.moneyMovementInfo .requestedAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.moneyMovementInfo .requestedAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.moneyMovementInfo .requestedAmount.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.moneyMovementInfo .requestedAmount.exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.moneyMovementInfo .requestedAmount.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.moneyMovementInfo .status |
token | Conditionally |
Indicates the success or failure of the monetary transaction type noted in the moneyMovementType field. Applicable values: See can:MoneyMovementStatusEnum |
cancelDetail.partialOrderType | token | Conditionally |
This value indicates whether the cancellation is for either a full or partial order. Currently, only full orders are eligible for cancellation. Applicable values: See PartialOrderTypeEnum |
cancelDetail.paymentStatus | token | Always |
The current status of the buyer's payment for the order that is being canceled or considered for cancellation. Applicable values: See PaymentStatusEnum |
cancelDetail.payoutRecoupInfo | PayoutRecoupInfo | Conditionally |
Defines the monetary amount of a payout. Payout amount data includes the sale price in the original currency with it's currency code, and any currency conversion information (as necessary), which includes the current currency code. |
cancelDetail.payoutRecoupInfo .amountToRecoup |
Amount | Conditionally | The monetary amount of the payout (paid by the payment system to the buyer) to recoup from the seller. |
cancelDetail.payoutRecoupInfo .amountToRecoup .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.payoutRecoupInfo .amountToRecoup .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.payoutRecoupInfo .amountToRecoup.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.payoutRecoupInfo .amountToRecoup.exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.payoutRecoupInfo .amountToRecoup.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.payoutRecoupInfo .payoutId |
integer | Conditionally | An unique eBay-assigned ID that identifies the payout to the buyer. |
cancelDetail.refundInfo | RefundInfo | Conditionally |
This container provides more information about a refund that was issued, or is scheduled to be issued for a cancelled order. This container is only returned if the seller's account is enabled for eBay managed payments. If the seller's account is not enabled for eBay managed payments, the refund information for the cancelled order is shown in a moneyMovementInfo node instead. |
cancelDetail.refundInfo .actualRefundDetail |
ActualRefundDetail | Conditionally | This container provides detailed information about a buyer refund that was issued, or is scheduled to be issued for a cancelled managed payments order. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund |
ActualRefund | Conditionally | This container shows the total amount of the buyer refund that has been issued for the cancelled order. If the actual refund has not occured yet, this container will not be returned. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.feeCreditAmount |
Amount | Conditionally | This container shows the total amount of fees credited towards this refund as per eBay policy. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.feeCreditAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.feeCreditAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.feeCreditAmount .currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.feeCreditAmount .exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.feeCreditAmount .value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.totalAmount |
Amount | Conditionally | The total amount of the refund that has been issued. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.totalAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.totalAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.totalAmount .currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.totalAmount .exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.refundInfo .actualRefundDetail .actualRefund.totalAmount .value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.refundInfo .actualRefundDetail.fundings |
array of RefundFundingType | Conditionally | This array shows more information about how the buyer refund was funded. There are multiple seller payment sources where the money can come from, and it is possible that the money can come from multiple seller payment sources. |
cancelDetail.refundInfo .actualRefundDetail.fundings .amount |
Amount | Conditionally | This container shows the amount of the refund. |
cancelDetail.refundInfo .actualRefundDetail.fundings .amount.convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail.fundings .amount.convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.refundInfo .actualRefundDetail.fundings .amount.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail.fundings .amount.exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.refundInfo .actualRefundDetail.fundings .amount.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.refundInfo .actualRefundDetail.fundings .date |
DateTime | Conditionally | This timestamp indicates when the buyer refund was issued. |
cancelDetail.refundInfo .actualRefundDetail.fundings .date.formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.refundInfo .actualRefundDetail.fundings .date.value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.refundInfo .actualRefundDetail.fundings .fundingSource |
FundingSourceType | Conditionally | This container provides details about the seller's funding source to issue the refund, such as a bank account, a credit card, or available seller payout funds. |
cancelDetail.refundInfo .actualRefundDetail.fundings .fundingSource.brand |
string | Conditionally |
The enumeration value here indicates the brand of credit card used to fund the refund. Currently, this field is only returned if the funding source type is CREDIT_CARD .
Applicable values are from FundingMethodBrandEnum: Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail.fundings .fundingSource.memo |
string | Conditionally | This provides a note about the funding source. This field is only returned if available. or it might get returned as an empty string. |
cancelDetail.refundInfo .actualRefundDetail.fundings .fundingSource.type |
string | Conditionally |
The enumeration value here indicates the type of funding source, such as bank account, credit card, or available seller payout funds.
Applicable values are from FundingMethodTypeEnum: Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail.fundings .fundingStatus |
string | Conditionally |
The enumeration value returned in this field indicates if the refunded was successful or not.
Applicable values are from FundingStatusEnum: Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .netChargeAmount |
Amount | Conditionally |
This container shows the total amount charged to the seller for this refund. The value will be in the seller's default currency. This container is only applicable to and returned if the seller's account is enabled for eBay managed payments. |
cancelDetail.refundInfo .actualRefundDetail .netChargeAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .netChargeAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.refundInfo .actualRefundDetail .netChargeAmount.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .netChargeAmount.exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.refundInfo .actualRefundDetail .netChargeAmount.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.refundInfo .actualRefundDetail .outstandingAmount |
Amount | Conditionally |
This field shows any outstanding dollar amount that is still due to the buyer for the refund. If a full refund has been successfully issued to the buyer, this value should be 0.0 .
|
cancelDetail.refundInfo .actualRefundDetail .outstandingAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .outstandingAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail.refundInfo .actualRefundDetail .outstandingAmount.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail.refundInfo .actualRefundDetail .outstandingAmount .exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail.refundInfo .actualRefundDetail .outstandingAmount.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.refundInfo .actualRefundDetail .refundIssuedDate |
DateTime | Conditionally | This timestamp indicates when the refund to the buyer. This field will not be returned if the refund has not occurred yet. |
cancelDetail.refundInfo .actualRefundDetail .refundIssuedDate .formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.refundInfo .actualRefundDetail .refundIssuedDate.value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.refundInfo .actualRefundDetail .refundStatus |
token | Conditionally |
The value in this field indicates the current status of the refund for the cancelled order. The value in this field should be SUCCESS , if the refund has been issued to buyer.
|
cancelDetail.requestorType | token | Always |
The reason why the user (either the buyer or the seller, as defined in the requestorType field) initiated the cancellation request. Applicable values: See PartyEnum |
cancelDetail .requestRefundAmount |
Amount | Conditionally |
The amount of the refund that the buyer is expecting to receive if the order is successfully canceled. The monetary amount indicated here is typically the full amount that the buyer paid for the order, including the item price and shipping fees. The information returned also includes any currency conversion information (as necessary), the current currency code, the value in the original currency, and the original currency's code. |
cancelDetail .requestRefundAmount .convertedFromCurrency |
string | Conditionally |
The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail .requestRefundAmount .convertedFromValue |
number | Conditionally |
The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated. |
cancelDetail .requestRefundAmount.currency |
string | Conditionally |
A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list. |
cancelDetail .requestRefundAmount .exchangeRate |
string | Conditionally | This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version. |
cancelDetail .requestRefundAmount.value |
number | Conditionally | The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type. |
cancelDetail.sellerLoginName | string | Conditionally | The eBay-assigned username of the account that represents the seller in the transaction. |
cancelDetail .sellerResponseDueDate |
DateTime | Conditionally |
A timestamp that indicates the time by which the seller is required to respond to an active cancellation request. This container is not returned if the cancellation request does not currently require a response from the seller. |
cancelDetail .sellerResponseDueDate .formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail .sellerResponseDueDate.value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
cancelDetail.shipmentDate | DateTime | Conditionally |
A timestamp that indicates the time when the seller shipped the order (or a line item within the order) that the buyer is attempting to cancel. Once a seller ships one or more line items within an order, the order is no longer eligible for cancellation. This container is only applicable and returned if the seller shipped one or more line items in order, thus making it impossible for the cancel request to be granted. |
cancelDetail.shipmentDate .formattedValue |
string | Conditionally | Reserved for future use. |
cancelDetail.shipmentDate .value |
datetime | Conditionally |
The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
|
Input Output Change History |
Samples
New to making API calls? Please see Making a Call.
Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.
Available samples:
- Get cancellation details ↓ - Retrieves the details of a specified cancellation request.
- Get refund details on a cancelled cross-border trade order ↓ - Retrieves refund details on a cancelled cross-border trade order
Retrieves the details of a specified cancellation request.
Description
This call returns the full details of a specified cancellation request, including the full history of the cancellation request and the line items in the order.
Input
The cancelId value is passed in as a path parameter at the end of the URI. The user uses the fieldgroups query parameter and sets its value to FULL
to retrieve full details on the cancellation request, including the full history of the cancellation request and the line items in the order.
URL format. See also the non-wrapped version of this URL. GET https://api.ebay.com/post-order/v2/cancellation/5********1?
fieldgroups=FULL
Output
This cancellation request (identified in the cancelId field) has just been created by the seller on behalf of the buyer, which is indicated by the value in the activityHistories.activityType field. When a seller cancels an order on behalf of a buyer, the seller gives the cancellation reason as BUYER_CANCEL_OR_ADDRESS_ISSUE
, which is indicated in the cancelDetail.cancelReason field. This cancellation reason given by the seller will ensure that the seller's account does not receive a seller defect. The cancelStateFrom and cancelStatetateTo values indicate that the seller has just initiated the cancellation request, and the next step is for the buyer to be refunded.
JSON format.
{
"cancelDetail": {
"cancelId": "5********1",
"marketplaceId": "EBAY_US",
"legacyOrderId": "0************9",
"requestorType": "SELLER",
"cancelReason": "BUYER_CANCEL_OR_ADDRESS_ISSUE",
"cancelState": "REFUND_PENDING",
"cancelStatus": "CANCEL_PENDING",
"paymentStatus": "PAYPAL_PAID",
"requestRefundAmount": {
"value": 2.46,
"currency": "USD"
},
"cancelRequestDate": {
"value": "2020-08-22T23:29:11.000Z",
},
"activityHistories": [
{
"activityType": "SELLER_CREATE_CANCEL",
"activityParty": "SELLER",
"actionDate": {
"value": "2020-08-22T23:29:07.000Z",
},
"cancelStateFrom": "INITIAL",
"cancelStatetateTo": "REFUND_PENDING"
}
]
}
}
Retrieves refund details on a cancelled cross-border trade order
Description
This call returns full details on a cancelled cross-border trade order. This particular order involved a Canadian seller (in eBay managed payments) selling an item on the eBay US marketplace. With managed payments, eBay actually refunds the buyer, and charges the seller. The response includes a netChargeAmount field that shows the net charge amount (to the seller) of the refund in Canadian dollars after the conversion of USD to CAD, and subtracting final values fees that will be reimbursed to the seller per eBay policy.
Input
The cancelId value is passed in as a path parameter at the end of the URI. The user uses the fieldgroups query parameter and sets its value to FULL
to retrieve full details on the cancellation request, including the full history of the cancellation request and the details on the refund.
URL format. See also the non-wrapped version of this URL. GET https://api.ebay.com/post-order/v2/cancellation/5********5?
fieldgroups=FULL
Output
This cancellation request was initiated by the buyer (see the BUYER_ASKED_CANCEL
value in the cancelReason field) and the seller accepted the request and agreed to fully refund the buyer (see the SELLER_CREATE_CANCEL
value in the first activityHistories.activityType node).
Since this is an eBay managed payments order, eBay refunded the buyer and billed the seller. The seller can see full details on the refund and how eBay recouped this money under the refundInfo container. eBay US was the listing site, so the total amount of the buyer refund (in actualRefund.totalAmount field) and the final value fee credit amount (in actualRefund.feeCreditAmount field) are shown in US dollars. The actualRefundDetail.netChargeAmount container shows the net charge amount of the refund in Canadian dollars after the conversion of USD to CAD, and subtracting the final values fees amount in actualRefund.feeCreditAmount field. The exchange rate used to perform the conversion is also shown in the actualRefundDetail.netChargeAmount container.
The actualRefundDetail.fundings container shows the seller's funding source to reimburse eBay for the buyer refund. In this case, eBay used the seller's available payout funds to recoup the buyer refund.
JSON format.
{
"cancelDetail": {
"cancelId": "5********5",
"marketplaceId": "EBAY_US",
"legacyOrderId": "0************9",
"requestorType": "SELLER",
"cancelReason": "BUYER_ASKED_CANCEL",
"cancelState": "CLOSED",
"cancelStatus": "CANCEL_CLOSED_WITH_REFUND",
"cancelCloseReason": "FULL_REFUNDED",
"partialOrderType": "FULL_ORDER",
"paymentStatus": "ONLINE_PAID",
"requestRefundAmount": {
"value": 34.67,
"currency": "USD"
},
"cancelRequestDate": {
"value": "2020-08-11T22:32:10.000Z"
},
"cancelCloseDate": {
"value": "2020-08-11T22:37:28.000Z"
},
"buyerLoginName": "p**********3",
"sellerLoginName": "c**********3",
"activityHistories": [
{
"activityType": "SELLER_CREATE_CANCEL",
"activityParty": "SELLER",
"actionDate": {
"value": "2020-08-11T22:32:10.000Z"
},
"stateFrom": "INITIAL",
"stateTo": "REFUND_PENDING"
},
{
"activityType": "SYSTEM_REFUND",
"activityParty": "UNKNOWN",
"actionDate": {
"value": "2020-08-11T22:32:11.000Z"
},
"stateFrom": "REFUND_PENDING",
"stateTo": "REFUND_INITIATED"
},
{
"activityType": "SYSTEM_NOTIFY_REFUND_STATUS",
"activityParty": "UNKNOWN",
"actionDate": {
"value": "2020-08-11T22:37:27.000Z"
},
"stateFrom": "REFUND_INITIATED",
"stateTo": "CLOSED"
}
],
"moneyMovementInfo": [
{
"moneyMovementType": "SELLER_VOLUNTARY_REFUND",
"status": "SUCCESS",
"requestedAmount": {
"value": 34.67,
"currency": "USD"
},
"actualAmount": {
"value": 34.67,
"currency": "USD"
},
"creationDate": {
"value": "2020-08-11T22:32:11.000Z"
}
}
],
"refundInfo": {
"actualRefundDetail": {
"actualRefund": {
"totalAmount": {
"value": 34.67,
"currency": "USD"
},
"feeCreditAmount": {
"value": 3.53,
"currency": "USD"
}
},
"netChargeAmount": {
"value": 40.38,
"convertedFromValue": 31.14,
"convertedFromCurrency": "USD",
"currency": "CAD",
"exchangeRate": "1.29665"
},
"outstandingAmount": {
"value": 0,
"currency": "CAD"
},
"fundings": [
{
"date": {
"value": "2020-08-11T22:32:11.556Z"
},
"amount": {
"value": 40.38,
"currency": "CAD"
},
"fundingSource": {
"type": "AVAILABLE_FUNDS"
},
"fundingStatus": "FUNDED"
}
]
}
}
}
}
Input Output Samples |
Change History
Change Date | Description |
---|