This parameter is the amount of the financial transaction.
The value also contains the decimal part of the transaction. Left (0) padding.
| Format | Length | Possible Values |
|---|---|---|
| Numeric | 11 | Example : $4,29 is “00000000429” |
The value is justified on the left for manual entry (inputType “M” or “I”) and must be completed with spaces (“ ”)
In the case of a transaction with a pinpad or a terminal (inputType “N”), the merchant must use an empty card number (40 spaces characters).
ApplePay and GooglePay use a “device ID” rather than the actual card number.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 40 |
The card type depends on the card used by the customer.
If the inputType is Internet (type “I”) and the merchant's site allows to specify a credit card type, for example “Visa”, the merchant can specify it with this field in the transaction.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 1 | If the inputType is “ N ” : Use a blank space If the inputType is “ I ” or “ M ” : “ A ” is for American Express “ M ” is for MasterCard “ I ” is for Diners “ V ” is for Visa “ O ” is for Discover NB : It is possible to use a blank space for an unknown card type |
The currency is the currency used for the financial transaction.
The value sent for this parameter does not defined in what currency the client will be charged, it is only an indicative information.
USD value should only be used when a merchant is setup with a US merchant number.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 3 | “CAD” for Canadian dollars. “USD” for American dollars. |
This parameter is the email address of the cardholder.
| Format | Length | Possible Values |
|---|---|---|
| Alpha | 240 | Example : “test@test.com” |
The expiration date is the one that is found on client credit card.
The card issuer is responsible for the expiration date validation.
The format is “MMYY” (2 numbers for the month and 2 numbers for the year).
In the case of a transaction with a pinpad or a terminal (inputType “N”), the merchant must use an empty expiration date (4 spaces characters).
| Format | Length | Possible Values |
|---|---|---|
| Numeric | 4 | Example:“0620” corresponding to July 2020 |
When requesting a redirection session, the merchant must provide a URL address to the payment solution.
This URL will be used to redirect the client if the transaction is a failure.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 240 | Example:“http://www.ctpaiement.com/failure.aspx“ |
Frequency code for the subscription.
| FORMAT | LENGTH | POSSIBLE VALUES |
|---|---|---|
| Numeric | 2 | |
For a recurring amount
| Code | Name | Description |
|---|---|---|
| 00 | Postponed | 1 withdrawal at a future date |
| 01 | Daily | 1 withdrawal each day |
| 02 | Weekly | 1 withdrawal each week the same day of the week as the beginning date |
| 03 | Monthly | 1 withdrawal each month the same day of the month as the beginning day (Withdrawal the last day of the month if the month is to short: February 31….) |
| 04 | Each 2 months | 1 withdrawal each 2 months the same day of the month as the beginning date |
| 05 | Quarterly | 1 withdrawal each 3 months the same day of the month as the beginning day |
| 06 | Haft year | 1 withdrawal each 4 months the same day of the month as the beginning day |
| 07 | 2x year | 1 withdrawal each 6 months the same day as the beginning day |
| 08 | Yearly | 1 withdrawal by year at the anniversary date of the beginning date |
| 09 | At each 2 weeks | 1 withdrawal each 14 days from the beginning day |
| 10 | 2x month | 2 monthly withdrawals. 1st in the 15 first days and 2nd 15 days after. If the month is too short, the 2nd will be made on the last day of the month. |
For a Total Payable Amount
The input type defines the method used by the merchant to execute the transaction.
This value shows which type of transaction the merchant wants to process.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 1 | “N” for terminal or pinpad transactions(Semi-Integrated) “I” for Internet (e-commerce) transactions “M” for mail order/telephone order (MOTO) “U” for unattended transactions |
Issuer Confirmation Number from online banking (Acxsys), to be displayed on the merchant's confirmation page.
Merchant must display this confirmation number on their confirmation screen.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 1-15 |
The IOP transaction id must be extracted from the IDEBIT_TRACK2.
The IDEBIT_TRACK2 is assigned by Issuer.
Contains PAN, Expiry Date, and Transaction ID. PAN and Transaction ID together must uniquely identify a Transaction. PAN begins with an IIN assigned to the Issuer for use with INTERAC Online Transactions only.
PAN (variable length up to 19 digits) + "=" + 4 digit Expiry Date (YYMM) + Transaction ID (13 alphanumeric chars) + zero padding up to 37 characters
Last digit of PAN is a mod10 check digit Expiry Date >= current system date.
Must match BM35 in the 200 Message (at least enough of it to uniquely identify the Transaction). The PAN must match BM2 in the 200 Message (except that BM2 is blank padded up to 19 characters). The definition of characters 21-24 as an “Expiry Date” is included for backward compatibility only; how it is used is up to the Issuer.
The language code specifies the language in which the merchant wants the PayFacto to send the response to the customer.
In redirection mode, the language code will be used to display the payment page in the appropriate language.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 1 | F is for FRENCH E is for ENGLISH |
The OEM Wallet data is generated by the mobile device authorized wallet.
For ApplePay, you must send the Apple payment token as received by the passkit.
For Google PayTM, you must send the payment token (paymentData.paymentMethodData.tokenizationData.token) as received by Google Pay API
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | Variable | JSON message |
The operator id is useful for identifying the cashier's name in the case of a point-of-sale terminal or a user in the case of a call center.
It is usually not used for Internet transactions. It allows the merchant to identify the employee, who generated the transaction on PayFacto's network.
It is always preferable to identify where the transaction originated from within the merchant's system.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 8 | Example:“USER0001” |
This number associated the merchant's invoice number with the initial financial transaction.
The original invoice number is generated by the merchant in the initial request. It will also be returned in the response of the initial transaction.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 12 | Example : “123456789123” |
When the new session creation has been successful, PayFacto returns a session identifier for the entire process of the transaction.
The session identifier is used when requesting the result of the transaction.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 50 | Example : “aasdf87a9sdg69sdf8s6d0fg76s9df8g6sd” |
This parameter is the status of either client, invoice or subscription.
| Format | Length | Possible Values |
|---|---|---|
| Numeric | 2 | |
Client Status
| Code | Name | |
|---|---|---|
| “01” | Active | The client is active and transactions can be made. |
| “02” | Expired | The client’s card is expired. All transactions will return an error. |
| “03” | No card set | There is no information on the credit card in the database. No transaction can be made. |
Invoice Status
| Code | Name | |
|---|---|---|
| “01” | Active | The invoice will be processed in the next execution. |
| “02” | In process | Withdrawal is in process. |
| “03” | Processed | Withdrawal is done, but some operations have to be done to finalize the transaction. |
| “04” | Completed | All operations are completed. This status is final. |
| “05” | Error | An error has happened during the withdrawal. |
| “06” | Suspended | The invoice is unpaid and won’t be processed in the next execution. |
| “07” | Expired | The client’s credit card is expired. An action is required from the merchant to modify the client’s card to reactivate the invoice. |
| “08” | Without card | No credit card information exists for the client. An action is required from the merchant to modify the client’s card to reactivate the invoice. |
Subscription Status
| Code | Name | |
|---|---|---|
| “01” | Active | Subscription is active and the withdrawals will take place as planned. |
| “50” | Pause | Subscription is temporarily suspended and the withdrawals won’t be made. |
When requesting a redirection session, the merchant must provide a URL address to the payment solution.
This URL will be used to redirect the client if the transaction is a success.
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 240 | Example:“http://www.ctpaiement.com/success.aspx“ |
This parameter is a special field to pass information to be printed on the terminal receipt using our Semi-Integrated solution. Please contact our integration team before using this field.
<FS>LineNumber(1 CHAR)FieldValue(Variable length-(27 CHAR)<FS>LineNumber (1 CHAR)FieldValue<FS>
Ex:
|1Lable Line 1: Value1|2Label Line 2:Value2|3Label Line 3: value3|4Label Line 4: 1234567890|5Label Line 5: 12345|6Label Line 6: value 6|
| Format | Length | Possible Values |
|---|---|---|
| Alphanumeric | 256 |