These docs are for v4.0.2. Click to read the latest docs for v4.3.0.

Card Tokenization

Batch card tokenization services allow merchants to store card tokens in a batch using SFTP connection.

👍

Connect using SFTP

  • IP Address : 52.76.184.174
  • Port : 22
  • Username : The merchant must fill in the SFTP setup form and send the request to support team. An account will be created for merchant to access 2c2p SFTP in demo and production environment.
  • Request Path : /input
  • Response Path : /output
  • Pickup Time For Request File : Everyday 2.00AM GMT+7
  • Drop Time For Response File : Everyday Before 3.00AM GMT+7

🚧

File Format Specification

  • File name format : token_YYYYMMDD_fileName.csv
  • Parameter delimiter : semicolon ';'
  • Record delimiter : line break
  • Encryption Method : GPG . Download the PGP Public Key here.

 

How to integrate


  1. Merchants must prepare the card tokenization request file. Refer to Card Tokenization Request.
  2. Encrypt the card tokenization request file using GPG.
  3. Upload the encrypted card tokenization request file into SFTP Server.
  4. 2C2P will pick up the card tokenization request file and process the payment.
  5. 2C2P will drop an encrypted card tokenization response file in SFTP Server.
  6. Merchants must get the encrypted card tokenization response file from SFTP Server.
  7. Decrypt the card tokenization response file using GPG.
  8. Read the response data as payment acknowledgement. Refer to Card Tokenization Response.

 

📘

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

Card Tokenization Request


Header Parameters

H;1.3;0000001;2015-01-01 00:00:01;2015-01-01 00:00:02;2
ParameterData TypeMandatoryDescription
recordTypeC 1MHeader = H
versionC 5MCurrent version is 1.3
merchantIDC 15MMerchant ID provided by 2C2P
createDateTimeC 19Myyyy-MM-dd HH:mm:ss (24 hours format)
processDateTimeC 19Myyyy-MM-dd HH:mm:ss (24 hours format), in merchant's local time
totalRecordN 5MTotal number of transactions

 

Detail Parameter

D;1;4111111111111111;12;2020;Joppie;data1;data2;data3;data4;data5
ParameterData TypeMandatoryDescription
recordTypeC 1MDetails = D
recordNoN 5Mrunning no 1 - 99999
panN 16MCredit card number
expiryMonthN 2MCredit card expiry month
expiryYearN 4MCredit card expiry year
cardholderNameC 50MCredit card holder name
userDefined1C 150OMerchant-defined information
userDefined2C 150OMerchant-defined information
userDefined3C 150OMerchant-defined information
userDefined4C 150OMerchant-defined information
userDefined5C 150OMerchant-defined information

 

Card Tokenization Response


Header Parameters

H;1.2;0000001;2015-01-02 00:00:02;4
ParameterData TypeMandatoryDescription
recrodTypeC 1MHeader = H
versionC 5MCurrent version is 1.3
merchantIDC 15MMerchant ID provided by 2C2P
completeDateTimeC 19MYYYY-MM-DD hh:mm:ss
totalRecordsN 5MTotal number of transactions

 

Detail Parameter

D;1;411111XXXXXX1111;09071513062949492475;data1;data2;data3;data4;data5;32;Completed tokenization without authorization.
ParameterData TypeMandatoryDescription
recordTypeC 1MDetails = D
recordNoC 5Mrunning no 1 - 99999
panN 16MMasked card number
storeCardUniqueIDC 20OStored card token
userDefined1C 150MMerchant-defined information
userDefined2C 150MMerchant-defined information
userDefined3C 150MMerchant-defined information
userDefined4C 150MMerchant-defined information
userDefined5C 150MMerchant-defined information
respCodeC 2MRefer to Card Response Code.
respDescC 100MRefer to Card Response Code.