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": ""
}

Parameter	Data Type / Length	Mandatory	Description
merchantID	AN 15	M	merchant ID Provided by 2C2P to merchant.
accountNo	AN 255	O	FULL Card Number / External Token
tokenProvider	C 15	M	Token Provider For "Add via Token" only CC - Card MA - MasterCard Token
name	C 50	C	Cardholder Name
email	C 50	O	Cardholder Email address
expiry	N 6	C	Account 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.
accountIssuer	C 50	O	Account Issuer Bank name.
accountIssuerCountry	C 2	O	Credit Card Issuer Bank Country Code
accountCurrency	C 3	O	Credit Card Primary Currency Code

Add Customer Response Parameters

{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": "",
    "tokenReference": "",
    "accountNo":"",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "channelCode": "",
    "subChannelCode": ""
}

Parameter	Data Type / Length	Mandatory	Description
responseCode	N 4	M	Response Code Refer to response code list.
responseDesc	AN 50	M	Response Description
merchantID	AN 15	M	Merchant ID provided by 2C2P
token	AN 255	O	Customer Token
tokenReference	AN 255	O	Optional Customer Token reference
accountNo	AN 255	O	Masked Account No
name	C 50	O	Cardholder Name
email	C 50	O	Cardholder Email address
expiry	N 6	O	Account 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.
subChannelCode	AN 15	O	Channel Code
accountIssuer	C 50	O	Account Issuer name.
accountIssuerCountry	C 2	O	Account Issuer country
accountCurrency	C 3	O	Account Currency Code

Update Customer Token Request Parameters

{
    "merchantID": "",
    "token": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": ""
}

Parameter	Data Type / Length	Mandatory	Description
merchantID	AN 15	M	Merchant ID provided by 2C2P
token	AN 255	M	Customer Token
name	C 50	M	Cardholder Name
email	C 50	O	Cardholder Email address
expiry	N 6	M	Account 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.
accountIssuer	C 50	O	Account Issuer name
accountIssuerCountry	C 2	O	Account Issuer Country Code
accountCurrency	C 3	O	Account Currency Code

Update Customer Token Response Parameters

{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "channelCode": "",
    "subChannelCode": ""
}

Parameter	Data Type / Length	Mandatory	Description
responseCode	N 4	M	Response Code Refer to response code list.
responseDesc	AN 50	M	Response Description
merchantID	AN 15	M	Merchant ID provided by 2C2P
token	AN 255	O	Customer Token
tokenReference	AN 255	O	Optional Customer Token reference
accountNo	AN 255	O	Masked Account No
name	C 50	O	Cardholder Name
email	C 50	O	Cardholder Email address
expiry	N 6	O	Account Token Expiry *Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
channelCode	AN 15	C	Channel Code
subChannelCode	AN 15	O	Sub Channel Code if applicable
accountIssuer	C 50	O	Account Issuer name
accountIssuerCountry	C 2	O	Account Issuer country
accountCurrency	C 3	O	Account Currency Code

Delete Customer Token Request Parameter

{
    "merchantID": "",
    "token": ""
}

Parameter	Data Type / Length	Mandatory	Description
merchantID	AN 15	M	Merchant ID provided by 2C2P
token	AN 255	C	Customer Token

Delete Customer Token Response Parameter

{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": ""
}

Parameter	Data Type / Length	Mandatory	Description
responseCode	N 4	M	Response code Refer to response code list.
responseDesc	AN 50	M	Response description
merchantID	AN 15	C	Merchant ID provided by 2C2P
token	AN 255	O	Customer Token

Inquiry Customer Token Request Parameter

{
    "merchantID": "",
    "token": ""
}

Parameter	Data Type / Length	Mandatory	Description
merchantID	AN 15	M	Merchant ID provided by 2C2P
token	AN 255	C	Customer Token

Inquiry Customer Token Response Parameters

{
    "responseCode": "",
    "responseDesc": "",
    "merchantID": "",
    "token": "",
    "name": "",
    "email": "",
    "expiry": "",
    "accountIssuer": "",
    "accountIssuerCountry": "",
    "accountCurrency": "",
    "channelCode": "",
    "subChannelCode": ""
}

Parameter	Data Type / Length	Mandatory	Description
responseCode	N 4	M	Response Code Refer to response code list.
responseDesc	AN 50	M	Response Description
merchantID	AN 15	M	Merchant ID provided by 2C2P
token	AN 255	O	Customer Token
name	C 50	O	Cardholder Name
email	C 50	O	Cardholder Email address
expiry	N 6	O	Account Token Expiry *Token Expiry in yyyy-MM-dd format (e.g 2012-02-01)
channelCode	AN 15	C	Channel Code
subChannelCode	AN 15	O	Sub Channel Code if applicable
accountIssuer	C 50	O	Account Issuer name
accountIssuerCountry	C 2	O	Account Issuer country
accountCurrency	C 3	O	Account Currency Code

📘Data Attribute Reference

Add Customer Request Parameters

Add Customer Response Parameters

Update Customer Token Request Parameters

Update Customer Token Response Parameters

Delete Customer Token Request Parameter

Delete Customer Token Response Parameter

Inquiry Customer Token Request Parameter

Inquiry Customer Token Response Parameters

📘
Data Attribute Reference