Authorization
Batch authorization services allow merchants to authorize a batch of payments 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 5.00AM GMT+7
- Drop Time For Response File : Everyday Before 8.00AM GMT+7
File Format Specification
- File name format : auth_YYYYMMDD_fileName.csv
- Parameter delimiter : semicolon ';'
- Record delimiter : line break
- Encryption Method : GPG
How to integrate
- Merchants must prepare the auth request file. Refer to Authorization Request.
- Encrypt the auth request file using GPG.
- Upload the encrypted auth request file to the SFTP Server.
- 2C2P will pick up the auth request file and process the payment.
- 2C2P will drop an encrypted auth response file in SFTP Server.
- Merchants must get the encrypted auth response file from SFTP Server.
- Decrypt the auth response file using GPG.
- Read the response data as payment acknowledgement. Refer to Authorization 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
Authorization Request
Header Parameters
H;1.4;0000001;2015-01-01 00:00:01;2015-01-01 00:00:02;2
Parameter | Data Type | Mandatory | Description |
---|---|---|---|
recrodType | C 1 | M | Header = H |
version | C 5 | M | Current version is 1.4 |
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 Parameters
D;1;Invoice00001;1 night hotel in bali;300.00;840;4111111111111111;12;2020;;123;Joppie tjoa;[email protected];data1;data2;data3;data4;data5;;;;;;;;;;;
D;2;Invoice00002;2 night hotel in bali;200.00;840;4111111111111111;12;2020;;123;Joppie tjoa;[email protected];;;;;;;;Y;RINV01;10.00;;;7;5;31122020;
D;3;Invoice00003;3 night hotel in bali;50.00;840;4111111111111111;12;2020;;123;Joppie tjoa;[email protected];data1;data2;data3;data4;data5;Y;3;M;Y;RINV02;100.00;Y;200.00;31;0;;0112
Parameter | Data Type | Mandatory | Description |
---|---|---|---|
recordType | C 1 | M | Details = D |
recordNo | N 5 | M | running no 1 - 99999 |
uniqueTransactionCode | C 20 | M | Transaction unique invoice number
|
desc | C 50 | M | Payment description
|
amount | D 12,2 | M | Transaction amount
|
currencyCode | N 3 | M | Standard ISO-4217 currency codes
|
pan | N 16 | M | Credit Card Number
|
expiryMonth | N 2 | M | Credit Card Expiry Month
|
expiryYear | N 4 | M | Credit Card Expiry Year
|
storeCardUniqueID | C 20 | O | Stored card token |
securityCode | N 4 | O | CVV2/CVC2/CID |
cardholderName | C 50 | M | Credit card holder name |
cardholderEmail | C 50 | O | Credit card holder email address |
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 |
ippTransaction | C 1 | O | N - Non-IPP payment
|
installmentPriod | N 2 | C | IPP installment period
|
interestType | C 1 | C | Interest type
|
recurring | C 1 | O | To enable RPP (Recurring Payment Plan) transaction feature
(Recurring unique ID will be returned on payment response message if this option is enabled) |
recurringPrefix | C 15 | C | Recurring Invoice Prefix |
recurringAmount | D 12,2 | C | Transaction amount.
|
recurringAllowAccumulate | C 1 | O | RPP will be terminated if accumulated failed RPP transaction amount is over maxAccumulateAmount.
|
recurringMaxAccumulateAmount | D 12,2 | C | RPP will be terminated if accumulated failed RPP transaction amount is over maxAccumulateAmount.
|
recurringInterval | N 2 | C | To indicate the frequency of RPP by days.
|
recurringCount | N 5 | C | To indicate how many times to charge the customer with RPP.
|
recurringChargeNextDate | N 8 | C | To indicate the next RPP charge date.
|
recurringChargeOnDate | N 4 | C | To charge RPP on specific date every month.
|
Authorization Response
Header Parameters
H;1.0;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 1.4 |
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 Parameters
D;1;Invoice00001;ABC123456;111222;0123456789;300.00;840;411111XXXXXX1111;;user1;user2;user3;;;;;00;approved
D;2;Invoice00002;ABC123458;111222;0123456789;600.00;840;411111XXXXXX1111;;user1;user2;user3;;;Y;3;M;123456;00;approved
Parameter | Data Type | Mandatory | Description |
---|---|---|---|
recordType | C 1 | M | Details = D |
recordNo | N 5 | M | running no 1 - 99999 |
uniqueTransactionCode | C 20 | M | Transaction unique invoice number
|
tranRef | C 28 | M | Routing trace reference number |
approvalCode | C 6 | M | Bank approval code |
refNumber | C 15 | M | Bank reference number |
amt | D 12,2 | M | Transaction amount
|
currencyCode | N 3 | M | Standard ISO-4217 currency codes
|
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 |
ippTransaction | C 1 | O | N - Non-IPP payment
|
installmentPriod | C 2 | C | IPP installment period
|
interestType | C 1 | C | Interest type
|
recurringUniqueID | N 20 | C | RPP transaction record identifier
|
respCode | C 2 | M | Refer to Card Response Code. |
respDesc | C 100 | M | Refer to Card Response Code. |
Updated almost 2 years ago