Customer Token Maintenance API

πŸ“˜

Data Attribute Reference

Data Type

  • A: Alphabet
  • AN: Alphanumeric
  • C: Characters
  • B: Boolean
  • D: Decimal
  • N: Numeric

Mandatory attributes

  • M: Mandatory
  • C: Conditional
  • O: Optional

Add Customer Request Parameters


{
    "merchantID": "",
    "accountNo": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "tokenProvider": ""
}
ParameterData Type / LengthMandatoryDescription
merchantIDAN 15Mmerchant ID Provided by 2C2P to merchant.
accountNoAN 255OFULL Card Number / External Token
tokenProviderC 15MToken Provider
For "Add via Token" only

CC - Card
MA - MasterCard Token
nameC 50CCardholder Name
emailC 50OCardholder Email address
expiryN 6CAccount Token Expiry
Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
For Credit Card, expiry day will be last day of the month.
accountIssuerC 50OAccount Issuer Bank name.
accountIssuerCountryC 2OCredit Card Issuer Bank Country Code
accountCurrencyC 3OCredit Card Primary Currency Code

Add Customer Response Parameters


{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": "",
    "tokenReference": "",
    "accountNo":"",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "channelCode": "",
    "subChannelCode": ""
}
ParameterData Type / LengthMandatoryDescription
responseCodeN 4MResponse Code

Refer to response code list.
responseDescAN 50MResponse Description
merchantIDAN 15MMerchant ID provided by 2C2P
tokenAN 255OCustomer Token
tokenReferenceAN 255OOptional Customer Token reference
accountNoAN 255OMasked Account No
nameC 50OCardholder Name
emailC 50OCardholder Email address
expiryN 6OAccount Token Expiry
Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
For Credit Card, expiry day will be last day of the month.
subChannelCodeAN 15OChannel Code
accountIssuerC 50OAccount Issuer name.
accountIssuerCountryC 2OAccount Issuer country
accountCurrencyC 3OAccount Currency Code

Update Customer Token Request Parameters


{
    "merchantID": "",
    "token": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": ""
}
ParameterData Type / LengthMandatoryDescription
merchantIDAN 15MMerchant ID provided by 2C2P
tokenAN 255MCustomer Token
nameC 50MCardholder Name
emailC 50OCardholder Email address
expiryN 6MAccount Token Expiry
Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
For Credit Card, expiry day will be last day of the month.
accountIssuerC 50OAccount Issuer name
accountIssuerCountryC 2OAccount Issuer Country Code
accountCurrencyC 3OAccount Currency Code

Update Customer Token Response Parameters


{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "channelCode": "",
    "subChannelCode": ""
}
ParameterData Type / LengthMandatoryDescription
responseCodeN 4MResponse Code

Refer to response code list.
responseDescAN 50MResponse Description
merchantIDAN 15MMerchant ID provided by 2C2P
tokenAN 255OCustomer Token
tokenReferenceAN 255OOptional Customer Token reference
accountNoAN 255OMasked Account No
nameC 50OCardholder Name
emailC 50OCardholder Email address
expiryN 6OAccount Token Expiry
*Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
channelCodeAN 15CChannel Code
subChannelCodeAN 15OSub Channel Code if applicable
accountIssuerC 50OAccount Issuer name
accountIssuerCountryC 2OAccount Issuer country
accountCurrencyC 3OAccount Currency Code

Delete Customer Token Request Parameter


{
    "merchantID": "",
    "token": ""
}
ParameterData Type / LengthMandatoryDescription
merchantIDAN 15MMerchant ID provided by 2C2P
tokenAN 255CCustomer Token

Delete Customer Token Response Parameter


{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": ""
}
ParameterData Type / LengthMandatoryDescription
responseCodeN 4MResponse code

Refer to response code list.
responseDescAN 50MResponse description
merchantIDAN 15CMerchant ID provided by 2C2P
tokenAN 255OCustomer Token

Inquiry Customer Token Request Parameter


{
    "merchantID": "",
    "token": ""
}
ParameterData Type / LengthMandatoryDescription
merchantIDAN 15MMerchant ID provided by 2C2P
tokenAN 255CCustomer Token

Inquiry Customer Token Response Parameters


{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "channelCode": "",
    "subChannelCode": ""
}
ParameterData Type / LengthMandatoryDescription
responseCodeN 4MResponse Code

Refer to response code list.
responseDescAN 50MResponse Description
merchantIDAN 15MMerchant ID provided by 2C2P
tokenAN 255OCustomer Token
nameC 50OCardholder Name
emailC 50OCardholder Email address
expiryN 6OAccount Token Expiry
*Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
channelCodeAN 15CChannel Code
subChannelCodeAN 15OSub Channel Code if applicable
accountIssuerC 50OAccount Issuer name
accountIssuerCountryC 2OAccount Issuer country
accountCurrencyC 3OAccount Currency Code