QuickPay
QuickPay batch services allowed merchant to send a batch of QuickPay payments 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 : Every hour
- Drop Time For Response File : Within the next hour
File Format Specification
- File name format : quickpay_YYYYMMDD_fileName.csv
- Parameter delimiter : pipe '|'
- Record delimiter : line break
- Encryption Method : None
How to integrate
- Merchants have to prepare the quickpay request file. Refer to Quickpay Request.
- Merchant is required to put quickpay request file into SFTP Server.
- 2c2p pickup the quickpay request file and process the payment.
- 2c2p will drop the quickpay response file in SFTP Server.
- Merchant is required to get the quickpay response file from SFTP Server.
- Merchant read the response data as payment acknowledgement. Refer to Quickpay Response.
Data Attribute Reference
Data Type
A - Alphabet, N - Numeric, AN - AlphaNumeric, C - Characters, D - Decimal, B - BooleanMandatory
M - Mandatory, C - Conditional, O - Optional
Quickpay Request
Header Parameter
H|1.0|0000001|2015-01-01 00:00:01|2015-01-01 00:00:02|3
| Parameter | Data Type | Mandatory | Description |
|---|---|---|---|
| recordType | C 1 | M | Header = H |
| version | C 5 | M | Current version is 1.1 |
| 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) |
| totalRecord | N 5 | M | total number of transactions |
Detail Parameter
D|1|Prefix001|promo package 2 days 1 night|SGD|1200.00|Y|100|31122016|mydata1|mydata2|mydata3|mydata4|mydata5|||https://my.returnurl.com/|A|||[email protected];[email protected]|||promotion package 2016 - kuta|2 days 1 nights at kuta beach villa||||||||||||
D|2|Prefix002|promo package 5 days 4 night|SGD|2200.00|Y|100|31122016|mydata1|mydata2|mydata3|mydata4|mydata5|||https://my.returnurl.com/|A||||||||+6589898989|Promotion - 5 days 4 nights in villa jimbaran|||N|||||||
D|3|Prefix003|promo package 5 days 4 night|SGD|3200.00|Y|100|31122016|mydata1|mydata2|mydata3|mydata4|mydata5|||https://my.returnurl.com/|A|||[email protected];[email protected]|||promotion package 2016 - uluwatu|5 days 4 nights at uluwatu beach villa|+6589898989|Promotion - 5 days 4 nights in villa uluwatu|||Y|49.00|N||30|12|01052020|
| Parameter | Data type | Mandatory | Description |
|---|---|---|---|
| recordType | C 1 | M | Details = D |
| recordNo | N 5 | M | running no 1 - 99999 |
| orderIdprefix | C 14 | M | Prefix of merchant order number for transaction done using this QuickPay URL. Only alphanumeric and special character of _- allowed. |
| description | N 12 | M | Description of QuickPay URL. Only alphanumeric and special character of ._#- allowed. |
| currency | C 3 | M | Standard ISO4217 currency codes. Eg. Thai baht = THB, Singapore dollar = SGD, US dollar = USD. |
| amount | N 12 | M | Transaction amount. E.g. SGD = 100.00, JPY = 100 |
| allowMultiplePayment | C 1 | O | Y = Yes, N = No. allow multiple payment to be made with this QP URL. Default value = N |
| maxTransaction | C 4 | O | "Maximum no of approved transaction allowed. Value 1 to 1000. If you have 10 items to sell, put 10 as value." |
| expiry | N 8 | M | Expiry date of the QP URL with format of DDMMYYYY |
| userData1 | C 255 | O | User data |
| userData2 | C 255 | O | User data |
| userData3 | C 255 | O | User data |
| userData4 | C 255 | O | User data |
| userData5 | C 255 | O | User data |
| promotion | C 20 | O | Promotion code to filter promotion transactions |
| categoryId | C 20 | O | Predefined payment category code for reporting purpose. |
| resultUrl2 | C 255 | O | Backend return url |
| paymentOption | C 1 | O | "To restrict customer payment methods / channel: - F – Full amount payment only - I – Installment payment plan only - C – Credit card payment only - A – All available options By default A option is selected." |
| ippInterestType | C 1 | O | "To allow merchant to specify IPP Interest type: - M – Merchant Pay interest option only - C – Customer Pay interest option only - A – all available options By default A is selected." |
| paymentExpiry | C 19 | O | "Allow merchant to specify payment expiry date/time for 1-2-3 service. Format: yyyy-MM-dd HH:mm:ss by default, expiry value is taken from merchant configuration." |
| toEmails | C 255 | O | Email address to be sent to, separated by semi-colon, “;”. |
| ccEmails | C 255 | O | Email address to receive CC, separated by semi-colon, “;”. |
| bccEmails | C 255 | O | Email address to receive BCC, separated by semi-colon, “;”. |
| emailSubject | C 255 | O M if 'toEmail' value is supplied | Characters except special character of > and < |
| emailMessage | C 255 | O M if 'toEmail' value is supplied | Characters except special character of > and < |
| toMobiles | C 255 | O | Mobile Nos to be sent to, separated by semi-colon, “;”. In International format: CountryCode-AreaCode-TelephoneNo. E.g +66889999999 |
| smsMessage | C 60 | O M if 'toMobile' value is supplied | Characters except special character of > and < |
| request3DS | C 1 | O | "To enable / disable / Force 3DS authentication Y - Do 3DS authentication (default) N - No 3DS authentication F - Force 3DS authentication (only ECI 02/05 are accepted)" |
| enableStoreCard | C 1 | O | "To enable tokenization feature N - Disable tokenization option (default) Y - Enable tokenization option" |
| recurring | C 1 | M | "To enable RPP (Recurring Payment Plan) transaction feature. N - Disable RPP feature (default) Y - Enable RPP feature (Recurring unique ID will be returned on payment response message if this option is enabled)" |
| recurringAmount | N 12 | C | Recurring amount. E.g. SGD = 100.00, JPY = 100 |
| recurringAllowAccumulate | C 1 | O | "RPP will be terminated if accumulated failed RPP transaction amount is over maxAccumulateAmount. Only required if allowAccumulate is allowed" |
| recurringMaxAccumulateAmount | N 12 | C | "RPP will be terminated if accumulated failed RPP transaction amount is over maxAccumulateAmount. Only required if allowAccumulate is allowed" |
| recurringInterval | N 2 | C | "To indicate the frequency of RPP by days. minimum is every 1 day. maximum is every 365 days (1 year). Only required if RPP is enabled and chargeOnDate is not used." |
| recurringCount | N 5 | C | "To indicate how many times to charge the customer with RPP. set to '0' to charge indefinitely until terminated manually. Only required if RPP is enabled." |
| recurringChargeNextDate | N 8 | C | "To indicate the next RPP charge date. format: ddMMyyyy. Only required if RPP with recurringInterval is set. if RPP is with chargeOnDate then chargeNextDate is optional. if chargeNextDate is not set, chargeOnDate Date and Month will be used" |
| recurringChargeOnDate | N 4 | C | "To charge RPP on specific date every month. format: ddMM the MM is only used if charge_next_date is not set. otherwise the dd will be used for every month. Only required if RPP is enabled and recurringInterval is not used." |
Quickpay Response
Header Parameter
H|1.1|0000001|2015-01-02 00:00:02|3
| Parameter | Data type | Mandatory | Description |
|---|---|---|---|
| recordType | C 1 | M | Header = H |
| version | C 5 | M | Current version 1.1 |
| 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|90001|Prefix001|SGD|1200.00|31122016|https://quickpay.2c2p.com/90001|[email protected]||[email protected]||000|success
D|1|90002|Prefix002|SGD|2200.00|31122016|https://quickpay.2c2p.com/90002||+6589898989|||000|success
D|1|90001|Prefix003|SGD|3200.00|31122016|https://quickpay.2c2p.com/90003|[email protected]|+65898989|[email protected]||000|success
| Parameter | Data type | Mandatory | Description |
|---|---|---|---|
| recordType | C 1 | M | Details = D |
| recordNo | N 5 | M | running no 1 - 99999 |
| qpID | C 28 | M | Routing trace reference number |
| orderIdPrefix | C 50 | M | Invoice No |
| currency | N 12 | M | "The refund amount will be padded with ‘0’ from the left and include no decimal point. Example: 1.00 = 000000000100, 1.50 = 000000000150" |
| amount | C 250 | M | Refund Note |
| expiry | n 8 | M | Expiry date of the QP URL with format of DDMMYYYY |
| url | C 255 | M | Quickpay URL |
| successEmails | C 255 | O | Email address successfully sent to, separated by semi-colon, “;”. |
| successMobiles | C 255 | O | Mobile Nos successfully sent to, separated by semi-colon, “;”. |
| failedEmails | C 255 | O | Email address failed to send to, separated by semi-colon, “;”. |
| failedMobiles | C 255 | O | Mobile Nos failed to send to, separated by semi-colon, “;”. |
| respCode | C 3 | M | Response status code |
| respDesc | C 50 | M | Response status short description |
Updated 8 months ago