Payment Card Token
NetSuite exposes the payment card token record to REST web services.
Payment card tokens represent payment cards without the need to save the payment card number (PAN). Typically, tokens are created automatically by gateway integrations. Payment gateways can update a token after the token is used. For more information, see Tokenization.
The payment card token record isn't a subrecord and doesn't have any subrecords of its own.
For information about using the REST API Browser, see The REST API Browser.
Record ID
The record ID for payment card token is paymentcardtoken.
Prerequisites
-
enable the Payment Instruments feature. For instructions, see Payment Instruments.
-
enable the Credit Card Payments feature. For instructions, see Setting Up Customer Credit Card Processing.
Code Samples
The code samples in this section show common use cases for payment card token.
Creating a Payment Card Token
POST https://123456.suitetalk.api.netsuite.com/services/rest//record/v1/paymentCardToken
{
"cardBrand": {
"id": "1"
},
"paymentMethod": {
"id": "19"
},
"cardExpirationDate": "2029-12",
"cardIssuerIdNumber": "123456789",
"cardLastFourDigits": "4111",
"cardNameOnCard": "John Smith",
"cardType": {
"id": "CREDIT"
},
"entity": {
"id": "28"
},
"isDefault": false,
"preserveOnFile": true,
"token": "tkntkntkntkn",
"tokenExpirationDate": "2029-12",
"tokenFamily": {
"id": "1"
},
"tokenNamespace": "NMSPC"
}
Updating a Payment Card Token
PATCH https://123456.suitetalk.api.netsuite.com/services/rest//record/v1/paymentCardToken/<id>
{
"memo": "Updated MEMO"
}