Refund Request Fields

Table 9

Refund Request Fields for the Simple Order API

Field Name	Description	Required / Optional	Data Type & Length
chinaRefundService_chinaPaymentRequestID	The requestID field returned from a previous request for chinaPaymentService. Creates a follow-on refund by linking the refund to the previous payment. For more information about request IDs, see Getting Started with CyberSource Advanced for the Simple Order API.	Required for CyberSource front-end processing; not used by the processor.	String (26)
chinaRefundService_chinaPaymentRequest Token	The requestToken value returned from a previous request for chinaPaymentService.   The field is an encoded string that contains no confidential information, such as an account number or card verification number. The string can contain a maximum of 256 characters.	Required for CyberSource front-end processing; not used by the processor.	String (256)
chinaRefundService_refundReason	Reason for the refund. Free-text explanation of why the refund is being processed. Banks prefer that the explanation be in Chinese so that bank employees can understand it easily.	Required by the processor.	String (80)
chinaRefundService_run	Whether to include chinaRefundService in your request. Possible values: ■ true: include the service in your request. ■ false (default): do not include the service in your request.	Required for CyberSource front-end processing; not used by the processor.	String (5)
item_#_unitPrice	Per-item price of the product. You must include either this field or purchaseTotals_grandTotalAmount in your request. The maximum amount is 50000.00. This value cannot be negative. You can include a decimal point (.) in this field, but you cannot include any other special characters. The amount will be truncated at the request level to the correct number of decimal places.	Required by the processor if purchaseTotals_grandTotalAmount is not in the request.	Decimal (15)
merchantID	Your CyberSource merchant ID. Use the same merchantID field for evaluation, testing, and production. Your CyberSource merchant ID field must correspond to only one PayEase merchant ID. Likewise, your PayEase merchant ID must correspond to only one CyberSource merchant ID.	Required for CyberSource front-end processing; not used by the processor.	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 on the Business Center and in CyberSource reports. For more information about order tracking, see Getting Started with CyberSource Advanced for the Simple Order API.	Required for CyberSource front-end processing; not used by the processor.	String (50)
purchaseTotals_grandTotalAmount	Grand total for the order. You must include either this field or item_0_unitPrice. The maximum amount is 50000.00.	Required by the processor if there are no offer lines in the request.	Decimal (15)