Request-Level Fields

Table 2

Request-Level Fields

Field	Description	Used By: Required (R) or Optional (O)	Data Type & Length
currency	Currency used for the order. For the possible values, see the ISO Standard Currency Codes.	ics_service_fee_calculate (R)	String (5)
customer_cc_number	Customer’s credit card number.	ics_service_fee_calculate (R)	Nonnegative integer (20)
grand_total_amount	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.	ics_service_fee_calculate (You must include either this field or offer0 and the offer-level field amount. For information about offers and grand totals, see Getting Started with CyberSource Advanced for the SCMP API.)	Decimal (15)
ics_applications	CyberSource services to process for the request. Set this field to ics_service_fee_calculate.	ics_service_fee_calculate (R)	String (255)
ignore_avs	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, as indicated by a reply flag value of DAVSNO. For successful service fee processing, set this value to yes. Possible values: ■ yes: Ignore the results of AVS checking and run the authorization for the service fee. ■ no (default): If the authorization receives an AVS decline, do not run the authorization for the service fee. When the value of this field is yes, the list in the decline_avs_flags field is ignored.	ics_auth (Required for service fee transactions)	String (3)
ignore_bad_cv	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 an auth_cv_result value of D or N. For successful service fee processing, set this value to yes. Possible values: ■ yes: Ignore the results of CVN checking and run the authorization for the service fee. ■ no (default): If the authorization receives a CVN decline, do not run the authorization for the service fee.	ics_auth (Required for service fee transactions)	String (3)
merchant_id	Your CyberSource merchant ID. Use the same merchant ID for evaluation, testing, and production.	ics_service_fee_calculate (R)	String (30)
merchant_ref_number	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 SCMP API.	ics_service_fee_calculate (R)	String (50)
service_fee_amount	Service fee.	ics_auth ics_auth_reversal ics_bill ics_ecp_debit Required for service fee transactions.	String (15)
service_fee_merchant_descriptor	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.	ics_auth (O) ics_bill (O)	String (22)
service_fee_merchant_descriptor_contact	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.	ics_auth (O) ics_bill (O)	String (11)
service_fee_merchant_descriptor_state	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.	ics_auth (O) ics_bill (O)	String (20)
1 To add this value to your CyberSource account, contact CyberSource Customer Support.