Request Fields Table 2 Request Fields Field Description Used By: Required (R)or Optional (O) Data Type & Length businessRules_ignoreAVSResult Flag that indicates whether to allow the authorization for the service fee to run even when the authorization for the principal amount receives an AVS decline. For successful service fee processing, set this value to true. Possible values: ■ true: Ignore the results of AVS checking and run the authorization for the service fee. ■ false (default): If the authorization receives an AVS decline, do not run the authorization for the service fee. When the value of this field is true, the list in the businessRules_declineAVSFlags field is ignored. ccAuthService (Required for service fee transactions) String (5) businessRules_ignoreCVResult Flag that indicates whether to allow the authorization for the service fee to run even when the authorization for the principal amount receives a CVN decline, as indicated by a ccAuthReply_cvCode value of D or N. For successful service fee processing, set this value to true. Possible values: ■ true: Ignore the results of CVN checking and run the authorization for the service fee. ■ false (default): If the authorization receives a CVN decline, do not run the authorization for the service fee. ccAuthService (Required for service fee transactions) String (5) card_accountNumber Customer’s credit card number. serviceFeeCalculateService (R) String with numbers only (20) item_#_unitPrice Per-item price of the product. This value cannot be negative. You can include a decimal point (.), but you cannot include any other special characters. CyberSource truncates the amount to the correct number of decimal places. serviceFeeCalculateService (You must include either this field or purchaseTotals_grandTotalAmount in your request. For information about items and grand totals, see Getting Started with CyberSource Advanced for the Simple Order API.) String (15) merchantID Your CyberSource merchant ID. Use the same merchant ID for evaluation, testing, and production. serviceFeeCalculateService (R) String (30) merchantReferenceCode Merchant-generated order reference or tracking number. CyberSource recommends that you send a unique value for each transaction so that you can perform meaningful searches for the transaction. For information about tracking orders, see Getting Started with CyberSource Advanced for the Simple Order API. serviceFeeCalculateService (R) String (50) purchaseTotals_currency Currency used for the order. For the possible values, see the ISO Standard Currency Codes. serviceFeeCalculateService (R) String (5) purchaseTotals_grandTotalAmount Grand total for the order. This value cannot be negative. You can include a decimal point (.), but you cannot include any other special characters. CyberSource truncates the amount to the correct number of decimal places. serviceFeeCalculateService (You must include either this field or item_#_unitPrice in your request. For information about items and grand totals, see Getting Started with CyberSource Advanced for the Simple Order API.) String (15) purchaseTotals_serviceFeeAmount Service fee. ccAuthService ccAuthReversalService ccCaptureService ecDebitService Required for service fee transactions. String (15) serviceFee_merchantDescriptor Name of the service provider that is collecting the service fee. The service provider name must consist of 3, 7, or 12 characters followed by an asterisk (*). This value must also include the words Service Fee. When you include more than one consecutive space, extra spaces are removed. Use one of the following formats for this value: ■ <3-character name>*Service Fee ■ <7-character name>*Service Fee ■ <12-character name>*Service Fee When payments are made in installments, this value must also include installment information such as 1 of 5 or 3 of 7. For installment payments, use one of the following formats for this value: ■ <3-character name>*Service Fee*<N> of <M> ■ <7-character name>*Service Fee*<N> of <M> ■ <12-character name>*Service Fee*<N> of <M> where <N> is the payment number and <M> is the total number of payments. When you do not include this value in your request, CyberSource uses the value that is in your CyberSource account.1 This value might be displayed on the cardholder’s statement. ccAuthService (O) ccCaptureService (O) String (22) serviceFee_merchantDescriptorContact Contact information for the service provider that is collecting the service fee. when you include more than one consecutive space, extra spaces are removed. When you do not include this value in your request, CyberSource uses the value that is in your CyberSource account.1 This value might be displayed on the cardholder’s statement. ccAuthService (O) ccCaptureService (O) String (11) serviceFee_merchantDescriptorState State or territory in which the service provider is located. When you do not include this value in your request, CyberSource uses the value that is in your CyberSource account.1 This value might be displayed on the cardholder’s statement. ccAuthService (O) ccCaptureService (O) String (20) serviceFeeCalculateService_run Whether to include serviceFeeCalculateService in your request. Set this field to true. serviceFeeCalculateService (R) String (5) 1 To add this value to your CyberSource account, contact CyberSource Customer Support.