Transcription
Simple Order API Fields
2021. Cybersource Corporation. All rights reserved.Cybersource Corporation (Cybersource) furnishes this document and the software described in this document under the applicable agreement between the reader of this document (You) and Cybersource(Agreement). You may use this document and/or software only in accordance with the terms of the Agreement. Except as expressly set forth in the Agreement, the information contained in this document is subjectto change without notice and therefore should not be interpreted in any way as a guarantee or warranty by Cybersource. Cybersource assumes no responsibility or liability for any errors that may appear in thisdocument. The copyrighted software that accompanies this document is licensed to You for use only in strict accordance with the Agreement. You should read the Agreement carefully before using the software.Except as permitted by the Agreement, You may not reproduce any part of this document, store this document in a retrieval system, or transmit this document, in any form or by any means, electronic, mechanical,recording, or otherwise, without the prior written consent of Cybersource.Restricted Rights LegendsFor Government or defense agencies: Use, duplication, or disclosure by the Government or defense agencies is subject to restrictions as set forth the Rights in Technical Data and Computer Software clause at DFARS252.227-7013 and in similar clauses in the FAR and NASA FAR Supplement.For civilian agencies: Use, reproduction, or disclosure is subject to restrictions set forth in subparagraphs (a) through (d) of the Commercial Computer Software Restricted Rights clause at 52.227-19 and thelimitations set forth in Cybersource Corporation's standard commercial agreement for this software. Unpublished rights reserved under the copyright laws of the United States.TrademarksAuthorize.Net, eCheck.Net, and The Power of Payment are registered trademarks of Cybersource Corporation. Cybersource, Cybersource Payment Manager, Cybersource Risk Manager, Cybersource Decision Manager,and Cybersource Connect are trademarks and/or service marks of Cybersource Corporation. Visa, Visa International, Cybersource, the Visa logo, and the Cybersource logo are the registered trademarks of VisaInternational in the United States and other countries. All other trademarks, service marks, registered marks, or registered service marks are the property of their respective owners.Simple Order API Fields 2
acquirerMerchantNumberIdentifier that was assigned to you by your acquirer.This value must be printed on the receipt.This field is supported only for Cybersource integrations.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: processorInformation.merchantNumber SCMP API Field: acquirer merchant number Simple Order API Field: acquirerMerchantNumberSimple Order API Fields 3
additionalDataAdditional information about a decline.This field is returned only for Visa Platform Connect.Specifications Field Type: Response Data Type: String Data Length: 255Mapping Information REST Field: processorInformation.responseDetails SCMP API Field: additional data Simple Order API Field: additionalDataSimple Order API Fields 4
additionalProcessorResponseProcessor-defined response category code.This field is returned only for: Japanese issuers Domestic transactions in Japan Credit Mutuel-CIC—the value returned in this field is a processor transaction ID required for troubleshooting. The associated detail error code is in theccAuthReply processorResponse field or the ccAuthReversalReply processorResponse field, depending on which service you requested.Specifications Credit Mutuel-CIC: Field Type: Response Data Type: String Data Length: 36 All other processors: Field Type: Response Data Type: Integer Data Length: 3Simple Order API Fields 5
Mapping Information REST API Field: processorInformation.responseCategoryCode SCMP API Field: additional processor response Simple Order API Field: additionalProcessorResponseSimple Order API Fields 6
aft foreignExchangeFeeFee the issuer charges when the recipient’s currency is not the same as the sender’s currency. When this fee is charged, the grand total amount must include the fee.Specifications Field Type: Request Data Type: String Data Length: 12Mapping Information REST API Field: orderInformation.amountDetails.foreignExchangeFee SCMP API Field: aft foreign exchange fee Simple Order API Field: aft foreignExchangeFeeSimple Order API Fields 7
aft indicatorIndicates whether the transaction is an AFT transaction.Possible values: true: This is an AFT transaction. false (default): This is not an AFT transaction.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: cator SCMP API Field: aft indicator Simple Order API Field: aft indicatorSimple Order API Fields 8
aft serviceFeeFee you are charging for the transaction. When this fee is charged, the grand total amount must include the fee.Specifications Field Type: Request Data Type: String Data Length: 12Mapping Information REST API Field: orderInformation.amountDetails.serviceFeeAmount SCMP API Field: aft service fee Simple Order API Field: aft serviceFeeSimple Order API Fields 9
airlineData leg # carrierCodeInternational Air Transport Association (IATA) code for the carrier for this leg of the trip.Required for each leg.Payer AuthenticationPayer Authentication services only use the first leg of the trip.Specifications Field Type: Request Data Type:String Data Length:2Mapping Information REST API Field: travelInformation.legs[].carrierCode SCMP API Field: airline leg# carrier code Simple Order API Field: airlineData leg # carrierCodeSimple Order API Fields 10
airlineData leg # departureDateDeparture date for the first leg of the trip.Format: YYYYMMDD.Payer AuthenticationThe numbered element name should contain 0 instead of #. Payer Authentication services only use the first leg of the trip.Specifications Field Type: Request Data Type: Integer Data Length: 8Mapping Information REST API Field: travelInformation.legs[].departureDate SCMP API Field: airline leg# leg departure date Simple Order API Field: airlineData leg # departureDateSimple Order API Fields 11
airlineData leg # destinationInternational Air Transport Association (IATA) code for the destination airport for this leg of the trip.Payer AuthenticationPayer Authentication services only use the first leg of the trip.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: travelInformation.legs[].destination SCMP API Field: airline leg# destination Simple Order API Field: airlineData leg # destinationSimple Order API Fields 12
airlineData numberOfPassengersNumber of passengers for whom the ticket was issued.If you do not include this field in your request, Cybersource uses a default value of 1.Specifications Field Type: Request Data Type: Integer Data Length: 3Mapping Information REST API Field: travelInformation.numberOfPassengers SCMP API Field: airline number of passengers Simple Order API Field: airlineData numberOfPassengersSimple Order API Fields 13
airlineData passenger # firstNameFirst name of the passenger to whom the ticket was issued.If there are multiple passengers, include all listed on the ticket. Do not include special characters such as commas, hyphens, or apostrophes. Only ASCII characters are supported.Specifications Field Type: Request Data Type: String Data Length: 60Mapping Information REST API Field: travelInformation.passengers[].firstName SCMP API Field: airline passenger# firstname Simple Order API Field: airlineData passenger # firstNameSimple Order API Fields 14
airlineData passenger # lastNameLast name of the passenger to whom the ticket was issued.If there are multiple passengers, include all listed on the ticket. Do not include special characters such as commas, hyphens, or apostrophes. Only ASCII characters are supported.Specifications Field Type: Request Data Type: String Data Length: 60Mapping Information REST API Field: travelInformation.passengers.[]lastName SCMP API Field: airline passenger# lastname Simple Order API Field: airlineData passenger # lastNameSimple Order API Fields 15
airlineData leg # originatingAirportCodeInternational Air Transport Association (IATA) code for the originating airport for the first leg of the trip.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: travelInformation.legs[].origination SCMP API Field: airline leg# originating airport code Simple Order API Field: airlineData leg # originatingAirportCodeSimple Order API Fields 16
apAuthReply processorTransactionIDProcessor transaction ID.This value is a unique identifier for the transaction.Specifications Field Type: Response Data Type: String Data Length: 50Mapping Information REST API Field: To be released soon SCMP API Field: ap auth processor trans id Simple Order API Field: apAuthReply processorTransactionIDSimple Order API Fields 17
apAuthReply reasonCodeNumeric value that corresponds to the result of the authorization request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apAuthReply reasonCodeSimple Order API Fields 18
apAuthReversalReply reasonCodeNumeric value that corresponds to the result of the authorization reversal request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apAuthReversalReply reasonCodeSimple Order API Fields 19
apCaptureReply reasonCodeNumeric value that corresponds to the result of the capture request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apCaptureReply reasonCodeSimple Order API Fields 20
apCheckStatusReply reasonCodeNumeric value that corresponds to the result of the check status request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apCheckStatusReply reasonCodeSimple Order API Fields 21
apOptionsReply reasonCodeNumeric value that corresponds to the result of the options request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apOptionsReply reasonCodeSimple Order API Fields 22
apRefundReply reasonCodeNumeric value that corresponds to the result of the refund request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apRefundReply reasonCodeSimple Order API Fields 23
apSaleReply processorTransactionIDProcessor transaction ID.This value is a unique identifier for the transaction.Specifications Field Type: Response Data Type: String Data Length: 50Mapping Information REST API Field: To be released soon SCMP API Field: ap sale processor trans id Simple Order API Field: apSaleReply processorTransactionIDSimple Order API Fields 24
apSaleReply reasonCodeNumeric value that corresponds to the result of the sale request.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apSaleReply reasonCodeSimple Order API Fields 25
apAuthReply amountAuthorized amount.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap auth amount Simple Order API Field: apAuthReply amountSimple Order API Fields 26
apAuthReply dateTimeDate and time when the service was requested.Specifications Field Type: Response Data Type: String Data Length: 20Mapping Information REST API Field: To be released soon SCMP API Field: ap auth date time Simple Order API Field: apAuthReply DateTimeSimple Order API Fields 27
apAuthReply merchantURLThe alternative payment service provider URL.Direct the customer to this URL after the transaction is completed.Service Alternative Payment AuthorizationSpecifications Field Type: Response Data Type: String Data Length: 2048Mapping Information REST API Field: To be released soon SCMP API Field: ap auth merchant url Simple Order API Field: apAuthReply merchantURLSimple Order API Fields 28
apAuthReply paymentStatusPayment authorization status.Possible value: AUTHORIZED: Payment successfully authorized. PENDING: Request received and waiting to be processed. FAILED: Request failed.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap auth payment status Simple Order API Field: apAuthReply paymentStatusSimple Order API Fields 29
apAuthReply processorResponseCode from the alternative payment processor that describes why the authorization is pending or failed.Specifications Field Type: Response Data Type: String Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap auth processor response Simple Order API Field: apAuthReply processorResponseSimple Order API Fields 30
apAuthReply reconciliationIDReference number for the transaction.You can use this value to reconcile Cybersource reports with processor reports.This value is not returned for all processors.Specifications Field Type: Response Data Type: Integer Data Length: 60Mapping Information REST API Field: To be released soon. SCMP API Field: ap auth trans ref no Simple Order API Field: apAuthReply reconciliationIDSimple Order API Fields 31
apAuthReply responseCodeResponse code from the processor.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap auth response code Simple Order API Field: apAuthReply responseCodeSimple Order API Fields 32
apAuthReversalReply amountAuthorized amount.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap auth reversal amount Simple Order API Field: apAuthReversalReply amountSimple Order API Fields 33
apAuthReversalReply dateTimeDate and time when the service was requested.Specifications Field Type: Response Data Type: String Data Length: 20Mapping Information REST API Field: To be released soon SCMP API Field: ap auth reversal date time Simple Order API Field: apAuthReversalReply DateTimeSimple Order API Fields 34
apAuthReversalReply paymentStatusAuthorization reversal status returned from the payment processor.Possible values: Auth-reversed: Authorization reversal successfully processed. Failed: Authorization reversal failed.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap auth reversalpayment status Simple Order API Field: apAuthReversalReply paymentStatusSimple Order API Fields 35
apAuthReversalReply processorResponseCode from the alternative payment processor that describes why the authorization reversal is pending or failed.Specifications Field Type: Response Data Type: String Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap auth reversal processor response Simple Order API Field: apAuthReversalReply processorResponseSimple Order API Fields 36
apAuthReversalReply reconciliationIDReference number for the transaction.You can use this value to reconcile Cybersource reports with processor reports.This value is not returned for all processors.Specifications Field Type: Response Data Type: Integer Data Length: 60Mapping Information REST API Field: To be released soon. SCMP API Field: ap auth reversal trans ref no Simple Order API Field: apAuthReversalReply reconciliationIDSimple Order API Fields 37
apAuthReply responseCodeResponse code from the processor.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap auth reversal response code Simple Order API Field: apAuthReversalReply responseCodeSimple Order API Fields 38
apAuthReversalService authRequestIDRequest ID of the authorization for which you are requesting this service.Specifications Field Type: Request Data Type: String Data Length: 26Mapping Information REST Field: To be released soon SCMP API Field: ap auth request id Simple Order API Fields: apAuthReversalService authRequestID apCaptureService authRequestIDSimple Order API Fields 39
apAuthReversalService runFlag that specifies whether to include the authorization reversal service in the request.Possible values: true: Include the authorization reversal service in the request. false (default): Do not include the authorization reversal service in the request.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apAuthReversalService runSimple Order API Fields 40
apAuthService cancelURLURL to which the customer is directed after cancelling the payment.Specifications Field Type: Request Data Type: String Data Length: 255Mapping Information REST Field: To be released soon SCMP API Field: ap auth cancel url Simple Order API Field: apAuthService cancelURLSimple Order API Fields 41
apAuthService failureURLURL to which the customer is directed after a payment fails.Specifications Field Type: Request Data Type: String Data Length: 255Mapping Information REST Field: To be released soon SCMP API Field: ap auth failure url Simple Order API Field: apAuthService failureURLSimple Order API Fields 42
apAuthService runFlag that specifies whether to include the authorization service in the request.Possible values: true: Include the authorization service in the request. false (default): Do not include the authorization service in the request.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apAuthService runSimple Order API Fields 43
apAuthService successURLURL to which the customer is directed after completing the payment.Specifications Field Type: Request Data Type: String Data Length: 255Mapping Information REST Field: To be released soon SCMP API Field: ap auth success url Simple Order API Field: apAuthService successURLSimple Order API Fields 44
apCaptureReply amountAuthorized amount.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap capture amount Simple Order API Field: apCaptureReply amountSimple Order API Fields 45
apCaptureReply paymentStatusCapture status returned from the payment processor.Possible values: Pending: Request received and waiting to be processed. Settled: Capture successfully processed. Failed: Capture failed.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap capture payment status Simple Order API Field: apCaptureReply paymentStatusSimple Order API Fields 46
apCaptureReply processorResponseCode from the alternative payment processor that describes why the capture is pending or failed.Specifications Field Type: Response Data Type: String Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap capture processor response Simple Order API Field: apCaptureReply processorResponseSimple Order API Fields 47
apCaptureReply reconciliationIDReference number for the transaction.You can use this value to reconcile Cybersource reports with processor reports.This value is not returned for all processors.Specifications Field Type: Response Data Type: Integer Data Length: 60Mapping Information REST API Field: To be released soon. SCMP API Field: ap capture trans ref no Simple Order API Field: apCaptureReply reconciliationIDSimple Order API Fields 48
apCaptureReply responseCodeResponse code from the processor.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap capture response code Simple Order API Field: apCaptureReply responseCodeSimple Order API Fields 49
apCaptureService authRequestIDRequest ID of the authorization for which you are requesting this service.Specifications Field Type: Request Data Type: String Data Length: 26Mapping Information REST Field: To be released soon SCMP API Field: ap auth request id Simple Order API Fields: apAuthReversalService authRequestID apCaptureService authRequestIDSimple Order API Fields 50
apCaptureService runFlag that specifies whether to include the capture service in the request.Possible values: true: Include the capture service in the request. false (default): Do not include the capture service in the request.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apCaptureService runSimple Order API Fields 51
apCheckStatusReply paymentStatusPayment status returned from the payment processor.Possible values: Pending: Request received and waiting to be processed. Settled: Payment successfully processed. Failed: Payment failed.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap check status payment status Simple Order API Field: apCheckStatusReply paymentStatusSimple Order API Fields 52
apCheckStatusReply processorResponseCode from the alternative payment processor that describes why the request is pending or failed.Specifications Field Type: Response Data Type: String Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap check status processor response Simple Order API Field: apCheckStatusReply processorResponseSimple Order API Fields 53
apCheckStatusReply reconciliationIDReference number for the transaction.You can use this value to reconcile Cybersource reports with processor reports.This value is not returned for all processors.Specifications Field Type: Response Data Type: Integer Data Length: 60Mapping Information REST API Field: To be released soon. SCMP API Field: ap check status trans ref no Simple Order API Field: apCheckStatusReply reconciliationIDSimple Order API Fields 54
apCheckStatusService checkStatusRequestIDRequest ID of the authorization, authorization reversal, capture, sale, or credit service for which you are requesting the check status service.Specifications Field Type: Request Data Type: String Data Length: 26Mapping Information REST Field: To be released soon SCMP API Field: ap check status request id Simple Order API Field: apCheckStatusService checkStatusRequestIDSimple Order API Fields 55
apCheckStatusService runFlag that specifies whether to include the check status service in the request.Possible values: true: Include the check status service in the request. false (default): Do not include the check status service in the request.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apCheckStatusService runSimple Order API Fields 56
apOptionsReply countThe number of options requested from the processor.Possible values: 1-250Specifications Field Type: Response Data Type: Integer Data Length: 3Mapping Information REST API Field: To be released soon SCMP API Field: ap options count Simple Order API Field: apOptionsReply countSimple Order API Fields 57
apOptionsService offsetOffset from the first item in the list of options received from the processor.If you want to display the options in multiple lists, this number represents the first option displayed in each list. Possible values: 0-9999Specifications Field Type: Response Data Type: Integer Data Length: 4Mapping Information REST Field: To be released soon SCMP API Field: ap options offset Simple Order API Field: apOptionsReply offsetSimple Order API Fields 58
apOptionsReply option # idUnique identifier associated with the option name.Example:option0 id:1 name:Currencyoption1 id:2 name:USDoption2 id:3 name:Minimum Amountoption3 id:4 name:1.00option4 id:5 name:Maximum Amountoption5 id:6 name:1000.00Specifications Field Type: Response Data Type: String Data Length: 34Mapping Information REST API Field: To be released soon SCMP API Field: ap option#id Simple Order API Field: apOptionsReply option # idSimple Order API Fields 59
apOptionsReply option # nameName associated with the option ID.Example:option0 id:1 name:Currencyoption1 id:2 name:USDoption2 id:3 name:Minimum Amountoption3 id:4 name:1.00option4 id:5 name:Maximum Amountoption5 id:6 name:1000.00Specifications Field Type: Response Data Type: String Data Length: 60Mapping Information REST API Field: To be released soon SCMP API Field: ap option#name Simple Order API Field: apOptionsReply option # nameSimple Order API Fields 60
apOptionsReply responseCodeResponse code from the processor.Specifications Field Type: Response Data Type: Integer Data Length: 5Mapping Information REST API Field: To be released soon. SCMP API Field: ap options response code Simple Order API Field: apOptionsReply responseCodeSimple Order API Fields 61
apOptionsReply totalCountThe total number of options requested from the processor.Possible values: 1-100000Specifications Field Type: Response Data Type: Integer Data Length: 6Mapping Information REST API Field: To be released soon SCMP API Field: ap options total count Simple Order API Field: apOptionsReply totalCountSimple Order API Fields 62
apOptionsService limitThe maximum number of options to be retrieved from the processor and displayed to the consumer.Possible values: 1-250.Specifications Field Type: Request Data Type: String Data Length: 3Mapping Information REST Field: To be released soon SCMP API Field: ap options limit Simple Order API Field: apOptionsService limitSimple Order API Fields 63
apOptionsService offset (Request)Offset from the first item in the list of options received from the processor.If you want to display the options in multiple lists, this number represents the first option displayed in each list. Possible values: 0-9999For example: apOptionsService limit 10 /limit offset 0 /offset /apOptionsService The example values display 10 options to the customer, starting with the first item on the list received from the processor.Specifications Field Type: Request Data Type: String Data Length: 4Mapping Information REST Field: To be released soon SCMP API Field: ap options offsetSimple Order API Fields 64
Simple Order API Field: apOptionsService offsetSimple Order API Fields 65
apOptionsService runFlag that specifies whether to include the capture service in the request.Possible values: true: Include the capture service in the request. false (default): Do not include the capture service in the request.Specifications Field Type: Request Data Type: String Data Length: 5Mapping Information REST API Field: No corresponding field SCMP API Field: No corresponding field Simple Order API Field: apOptionsService runSimple Order API Fields 66
apPaymentTypeThree-digit value that indicates the payment type.Possible values: afp: Afterpay and ClearpaySpecifications Field Type: Request Data Type: String Data Length: 3Mapping Information REST Field: To be released soon SCMP API Field: ap payment type Simple Order API Field: apPaymentTypeSimple Order API Fields 67
apRefundReply amountAuthorized amount.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon SCMP API Field: ap refund amount Simple Order API Field: apRefundReply amountSimple Order API Fields 68
apRefundReply dateTimeDate and time when the service was requested.Specifications Field Type: Response Data Type: String Data Length: 20Mapping Information REST API Field: To be released soon SCMP API Field: ap refund date time Simple Order API Field: apRefundReply DateTimeSimple Order API Fields 69
apRefundReply paymentStatusRefund status returned from the payment processor.Possible values: Pending: Request received and waiting to be processed. Refunded: Refund successfully processed. Failed: Refund failed.Specifications Field Type: Response Data Type: String Data Length: 15Mapping Information REST API Field: To be released soon
REST API Field: orderInformation.amountDetails.foreignExchangeFee SCMP API Field: aft_foreign_exchange_fee Simple Order API Field: aft_foreignExchangeFee . You can use this value to reconcile Cybersource reports with processor reports. This value is not returned for all processors.
