Payment Request Fields Table 7 Payment Request Fields for the Simple Order API Field Name Description Required / Optional Data Type & Length billTo_city Billing city as it appears in the financial institution’s records. Optional. String (50) billTo_country Billing country as it appears in the financial institution’s records. Use the two-character country codes. Optional. String (2) billTo_email Customer’s email address, including the full domain name. Example: jdoe@example.com Optional. String (255) billTo_firstName Customer’s entire name or first name. This value should be the same as the one that appears in the financial institution’s records. Note A name must be provided. You can do one of the following: ■ Provide the entire name in the first-name field. ■ Provide the entire name in the last-name field. ■ Provide the first name in the first-name field and the last name in the last-name field. Optional if the customer’s first and last name are combined as a single value in the last-name field; otherwise, required by the processor. String (60) billTo_lastName Customer’s entire name or last name. This value should be the same as the one that appears in the financial institution’s records. Note A name must be provided. You can do one of the following: ■ Provide the entire name in the first-name field. ■ Provide the entire name in the last-name field. ■ Provide the first name in the first-name field and the last name in the last-name field. Optional if the customer’s first and last name are combined as a single value in the first-name field; otherwise, required by the processor. String (60) billTo_postalCode Postal code for the billing address. If the billing country is not the U.S. or Canada, any string up to 9 characters is accepted. If the billing country is the U.S., the 9-digit postal code must follow this format: [5 digits][dash][4 digits] Example 12345-6789 If the billing country is Canada, the 6-digit postal code must follow this format: [alpha][numeric][alpha][space][numeric][alpha][numeric] Example A1B 2C3 Optional. String (9) billTo_street1 Billing street address as it appears in the financial institution’s records. Optional. String (60) billTo_street2 Additional address information. Optional. String (60) chinaPaymentService_paymentMode Payment Mode. Contact PayEase for the mapping of the supported payment system names to the PayEase payment mode values. Ask for the report titled Banks & Payment Channels Supported by PayEase Payment Platform. Required by the processor. Integer (3) chinaPaymentService_returnURL URL that will be used to return the customer to your web site after the transaction. Do not include parameters at the end of the URL. Example of correct URL: http://example.com/checkout.jsp Example of incorrect URL: http://example.com/checkout.jsp?orderID=12345 Required by the processor. String (512) chinaPaymentService_run Whether to include chinaPaymentService 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 is 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 merchant ID for evaluation, testing, and production. Your CyberSource merchant ID 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 tracking orders, 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_currency Currency used for the order. Possible values: ■ CNY (RMB) ■ USD: USD can be used only for international cards and only for products and services that are priced in USD. CyberSource verifies that the value is either CNY or USD and that it is active in your CyberSource merchant configuration. Required by the processor. String (5) 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) shipTo_city City of the shipping address. If any shipping information is in the request and if the shipping country is the U.S. or Canada, this field is required for CyberSource front-end processing.* String (50) shipTo_country Country of the shipping address. Use the two-character ISO Standard Country Codes. If any shipping information is in the request, this field is required for CyberSource front-end processing.* String (2) shipTo_firstName Entire name or first name of the recipient. If any shipping information is in the request, this field is required for CyberSource front-end processing.* String (60) shipTo_lastName Last name of the recipient. Optional if the recipient’s first name and last name are combined as a single value in the ship-to first-name field; otherwise, required for CyberSource front-end processing if any shipping information is in the request.* String (60) shipTo_phone Phone number for the shipping address. Include the country code. If any shipping information is in the request, this field is required for CyberSource front-end processing.* String (20) shipTo_postalCode Postal code for the shipping address. The postal code must consist of 5 to 9 digits. When the shipping country is the U.S., the 9-digit postal code must follow this format:[5 digits][dash][4 digits] Example 12345-6789 When the shipping country is Canada, the 6-digit postal code must follow this format:[alpha][numeric][alpha][space][numeric][alpha][numeric] Example A1B 2C3 If the shipping country is not the U.S. or Canada, any string up to 9 characters is accepted. If any shipping information is in the request and if the shipping country is the U.S. or Canada, this field is required for CyberSource front-end processing.* String (9) shipTo_street1 First line of the shipping address. If any shipping information is in the request, this field is required for CyberSource front-end processing.* String (60) shipTo_street2 Second line of the shipping address. Optional. String (60) * If one shipping field is included, they all must be included, except shipTo_street2, which is always optional.