The customer token represents customer-related information including details for a payment card or electronic check, billing address, shipping address, and merchant-defined data. For a description of all token types, see Token Types and Formats.
You can configure your merchant ID to request an automatic account verification (also known as a 0.0 or 1.00 preauthorization) when you create a token. If the verification fails, the token is not created. Contact Cybersource Customer Support to enable this for your merchant ID. See Authorize and Create a Customer Token for a Payment Card.
The customer token is returned in the pay_subscription_create_subscription_id field. The instrument identifier token is also returned in the pay_subscription_create_instrument_identifier_id field and can be used to analyze customer PAN and electronic check usage across multiple customer tokens.
Creating a Customer Token for a Payment Card
To request a payment card customer token:
Step 1Set the ics_applications service field to ics_pay_subscription_create.
Step 2Include the following required fields in the request:
nbill_address1
nbill_city
nbill_country
nbill_state
nbill_zip
ncard_type
ncurrency
ncustomer_cc_expmo
ncustomer_cc_expyr
ncustomer_cc_number
ncustomer_email
ncustomer_firstname
ncustomer_lastname
ncustomer_phone
nmerchant_id
nmerchant_ref_number
nrecurring_frequency—set to on-demand
nship_to_address1
nship_to_city
nship_to_country
nship_to_firstname
nship_to_lastname
nship_to_state
nship_to_zip
For detailed descriptions of request and reply fields, see API Fields. For examples, see Examples.