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
- Merchants must prepare the card tokenization request file. Refer to Card Tokenization Request.
- Encrypt the card tokenization request file using GPG.
- Upload the encrypted card tokenization request file into SFTP Server.
- 2C2P will pick up the card tokenization request file and process the payment.
- 2C2P will drop an encrypted card tokenization response file in SFTP Server.
- Merchants must get the encrypted card tokenization response file from SFTP Server.
- Decrypt the card tokenization response file using GPG.
- 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
| Parameter | Data Type | Mandatory | Description |
|---|---|---|---|
| recordType | C 1 | M | Header = H |
| version | C 5 | M | Current version is 1.3 |
| merchantID | C 15 | M | Merchant ID 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 number |
| 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 Parameters
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 | Merchant ID 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. |
Updated about 2 years ago