Refund Request Fields

 

Table 14

Refund Request Fields for the SCMP API

Field Name	Description	Required / Optional	Data Type & Length
china_payment_request_id	The request ID returned from a previous request for ics_china_payment. 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 SCMP API.	Required for CyberSource front-end processing; not used by the processor.	String (26)
china_payment_request_token	The request_token value returned from a previous request for ics_china_payment.   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)
grand_total_amount	Grand total for the order. You must include either this field or offer0 and the offer-level field amount. The maximum amount is 50000.00.	Required by the processor if there are no offer lines in the request.	Decimal (15)
ics_applications	Service to process for the request. For a refund request, this value should be ics_china_refund.	Required for CyberSource front-end processing; not used by the processor.	String (255)
merchant_id	Your CyberSource merchant ID. Use the same merchant_id 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)
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 on the Business Center and in CyberSource reports. For more information about order tracking, see Getting Started with CyberSource Advanced for the SCMP API.	Required for CyberSource front-end processing; not used by the processor.	String (50)
offerN: amount	Per-item price of the product. You must include either offer0 and this field, or the request-level field grand_total_amount 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 is truncated at the request level to the correct number of decimal places.	Required by the processor if grand_total_amount is not in the request	Decimal (15)
refund_reason	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)