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 paySubscriptionCreateReply_subscriptionID field. The instrument identifier token is also returned in the paySubscriptionCreateReply_instrumentIdentifierID 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 paySubscriptionCreateService_run service field to true.
Step 2Include the following required fields in the request:
nbillTo_city
nbillTo_country
nbillTo_email
nbillTo_firstName
nbillTo_lastName
nbillTo_phoneNumber
nbillTo_postalCode
nbillTo_state
nbillTo_street1
ncard_accountNumber
ncard_cardType
ncard_expirationMonth
ncard_expirationYear
nmerchantID
nmerchantReferenceCode
npurchaseTotals_currency
nrecurringSubscriptionInfo_frequency—set to on-demand
nshipTo_city
nshipTo_country
nshipTo_firstName
nshipTo_lastName
nshipTo_postalCode
nshipTo_state
nshipTo_street1
For detailed descriptions of request and reply fields, see API Fields. For examples, see Examples.