Card Tokenization

Batch card tokenization services is allowed merchant to store card in a batch using SFTP connection.

👍

Connect using SFTP

  • IP Address : 52.76.184.174
  • Port : 22
  • Username : Merchant required to 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

 

How to integrate


  1. Merchants have to prepare the card tokenization request file. Refer to Card Tokenization Request.
  2. Merchant is required to encrypt the card tokenization request file using GPG.
  3. Merchant is required to put encrypted card tokenization request file into SFTP Server.
  4. 2c2p pickup the card tokenization request file and process the payment.
  5. 2c2p will drop a encrypted card tokenization response file in SFTP Server.
  6. Merchant is required to get the encrypted card tokenization response file from SFTP Server.
  7. Merchant is required to decrypt card tokenization response file using GPG.
  8. Merchant read the response data as payment acknowledgement. Refer to Card Tokenization Response.

 

📘

Data Attribute Reference

Data Type
A - Alphabet, N - Numeric, AN - AlphaNumeric, C - Characters, D - Decimal, B - Boolean

Mandatory
M - Mandatory, C - Conditional, O - Optional

Card Tokenization Request


Header Parameter

H;1.3;0000001;2015-01-01 00:00:01;2015-01-01 00:00:02;2

Parameter

Data Type

Mandatory

Description

recordType

C 1

M

Header = H

version

C 5

M

Current version is 1.3

merchantID

C 15

M

MID provided by 2c2p

createDateTime

C 19

M

yyyy-MM-dd HH:mm:ss (24 hours format)

processDateTime

C 19

M

yyyy-MM-dd HH:mm:ss (24 hours format), in merchant's local time

totalRecord

N 5

M

total number of transactions

 

Detail Parameter

D;1;4111111111111111;12;2020;Joppie;data1;data2;data3;data4;data5

Parameter

Data Type

Mandatory

Description

recordType

C 1

M

Details = D

recordNo

N 5

M

running no 1 - 99999

pan

N 16

M

Credit Card No

expiryMonth

N 2

M

Credit Card expiry month

expiryYear

N 4

M

Credit Card expiry year

cardholderName

C 50

M

Credit Card holder name

userDefined1

C 150

O

Merchant Defined information

userDefined2

C 150

O

Merchant Defined information

userDefined3

C 150

O

Merchant Defined information

userDefined4

C 150

O

Merchant Defined information

userDefined5

C 150

O

Merchant Defined information

 

Card Tokenization Response


Header Parameter

H;1.2;0000001;2015-01-02 00:00:02;4

Parameter

Data Type

Mandatory

Description

recrodType

C 1

M

Header = H

version

C 5

M

Current version is 1.3

merchantID

C 15

M

MID provided by 2c2p

completeDateTime

C 19

M

YYYY-MM-DD hh:mm:ss

totalRecords

N 5

M

total number of transactions

 

Detail Parameter

D;1;411111XXXXXX1111;09071513062949492475;data1;data2;data3;data4;data5;32;Completed tokenization without authorization.

Parameter

Data Type

Mandatory

Description

recordType

C 1

M

Details = D

recordNo

C 5

M

running no 1 - 99999

pan

N 16

M

masked card number

storeCardUniqueID

C 20

O

stored card token

userDefined1

C 150

M

Merchant Defined information

userDefined2

C 150

M

Merchant Defined information

userDefined3

C 150

M

Merchant Defined information

userDefined4

C 150

M

Merchant Defined information

userDefined5

C 150

M

Merchant Defined information

respCode

C 2

M

Refer to Card Response Code.

respDesc

C 100

M

Refer to Card Response Code.