Request Fields

 

Table 2

Request Fields

Field Name	Description	Used By: Required (R) or Optional (O)	Data Type & Length
ap_initiate_request_id	Identifier returned from the initiate payment service request.	Check Status (R) Refund (R)	String (26)
ap_initiate_product_ description	Description of the product offered to the customer. Important If you are using Chinese characters, the maximum string length is shorter.	Initiate Payment (O)	String (255)
ap_initiate_product_name	Product offered to the customer. Important If you are using Chinese characters, the maximum string length is shorter.	Initiate Payment (R)	String (105)
ap_initiate_return_url	The web page to which the customer is directed when the transaction is complete. Important This URL overrides the URL that was specified when the merchant account was created.	Initiate Payment (O)	String (200)
ap_payment_type	Identifier for the payment type. Values: ■ APD: web payment ■ ADM: mobile payment	Initiate Payment (R) Check Status (R) Refund (R)	String (3)
ap_refund_reason	Text describing the reason for the refund.	Refund (R)	String (100)
currency	Currency used for the order. Value: CNY	Initiate Payment (R)	String (10)
grand_total_amount	Grand total for the order. For more information about items and grand totals, see Getting Started with CyberSource Advanced for the SCMP API (PDF | HTML).	Initiate Payment (R) Refund (R)	String (10)
ics_applications	CyberSource services to process for the request. Possible values: ■ Initiate Payment Service: ics_ap_initiate ■ Check Status Service: ics_ap_check_status ■ Refund Service: ics_ap_refund	Initiate Payment (R) Check Status (R) Refund (R)	String (256)
merchant_id	Your CyberSource merchant ID.	Initiate Payment (R) Check Status (R) Refund (R)	String (50)
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 more information about tracking orders, see Getting Started with CyberSource Advanced for the SCMP API (PDF | HTML).	Initiate Payment (R) Check Status (R) Refund (R)	String (50)