Direct Debit (EN)
Direct debit is for closed and secured systems or Android/IOS native apps.
The charge is done without being redirected to a secured Cardcom Page with PCI certificate.
you need "low profile" module The module is not suitable for working with websites. In order to work .with websites
Refer to guide - > low profile interface - create, charge token etc. [part1 + 2
Important: during work with direct debit there is no option to get a PCI certificate form cardcom.
You must acquire it yourself from the credit card company. You must NOT keep the card details including CVV but only send them through the interface.
Interface to Name to Value:
1. Must send request in POST only. Get is for tests.
2. Must do URLENCODE for all parameters that are sent to the system
Index:
Red parameter = mandatory
Bold parameter = recommended
Non red or bold = optional
Function address in - Name to Value is: https://secure.cardcom.solutions/Interface/Direct2.aspx
Request parameters chart:
Number | Parameter | Possible values | Description |
1 | TerminalNumber | 1000 | Internal terminal Number (not shava) to charge |
2 | UserName | fdgdfds43324 | Api User Name |
3 | UserPassword | dsfds324234 | Password (only for refunds) |
4 | Sum | 15 | Total |
5 | Languages | he/en | Language |
6 | Coinid/CoinISOName | Currency values according to the following table | Currency |
7 | eli@gmail.com | Card owner's email | |
8 | CardOwnerName | Eli Cohen | Card owner's name |
9 | Identitynumber | 123456789 | Card owner's ID |
10 | CardValidityMonth | 12 | Card month expiry (need to save to DB in order to charge token later) |
11 | CardValidityYear | 20 | Card year expiry (need to save to DB in order to charge token later) |
12 | CardNumber | 4580000000000000 | Card Number |
13 | codepage=65001 |
| סוג הקידוד המועבר למערכת יוניקוד |
14 | Token | AA-BB-CC | Token to charge card (need to save to DB in order to charge token later) |
15 | UniqAsmachta | Unique deal ID Recommended auto num String of up to 25 characters AABB12347 | You must send the unique ID of the transaction in your system. If we get the same ID again the system would return - double deal and the deal will not go through Refer to preventing double deals with token charges. |
16 | CardChannel2 | you must run the card or input the card number | Channel 2 of the card |
17 | Cvv | 123 | 3digits at the back of the card |
18 | Jparameter | 2=check 5=approval (card limit hold) | Type of card check |
19 | Approvalnumber | 00214215 | Approval number (optional with J5) |
20 | Mti | 420 (fixed value) | Parameter to release card limit (approval number required) |
21 | NumOfPayments | 1 | Payments number (equal payments) |
22 | firstpaymentsum | 200 | First payment (can be a different amount from the rest) (optional) |
23 | constpayment | 50 | Fixed payment (second payment forward) (optional) |
24 | UniqAsmachtaReturnOriginal | false | Return original response during double deal instead of double deal error? |
25 | CreateToken | false | Create card token using card expiration date (recurring payments) |
26 | TokenCompanyUserName |
| Optional - which company has the token to charge (wandering token) |
27 | TokenCompanyPassword |
| Optional - which company has the token to charge (wandering token) |
28 | TokenSaveTime | 3 | Optional - for how many months to keep the card (regardless of token expiry) |
29 | Credittype | 1=regular 8=payments in credit | Deal type that is sent to the credit card company |
30 | AvsCity | AVS - active only in EMV terminals | Card owner's city |
31 | AvsAddress | AVS - active only in EMV terminals | Card owner's address |
32 | AvsZip | AVS - active only in EMV terminals | Card owner's zip code |
33 | IsAutoRecurringPayment | true | Charging recurring payments in EMV terminals only parameter must be true (optional). deal will be marked as recurring payments and not regular payments. Must have credit card company approval for recurring payments terminal. (for a UPAY terminal money will be transfered after the 15th of following month) Changed cards file from the credit card comapny - updating changed card file from credit card company |
34 | SapakMutav |
| Terminal must be set as rav mutav in cardcom. Client number during work in rav mutav- need credit card company approval |
Invoice parameters in direct debit:
Number | Parameter | Possible values | Description |
1 | InvCreateInvoice | 1 = create invoice 2 = don't create | Create invoice? |
2 | InvCusAddress1 | Eben Gabirol | Address line 1 |
3 | InvCusAddress2 | Number 120 | Address line 2 |
4 | InvCusCity | Tel Aviv | City |
5 | InvCusID | 1 = Dollar 2 = Shekel | Currency code for invoice. Must be the same as charge currency |
6 | invCustName | Eli Cohen ltd | Client's name on the invoice |
7 | invDestEmail | eli@gmail.com | Client's email |
8 | InvItemDescription | item1 | Item description on invoice |
9 | InvIsSendSMS |
|
|
10 | InvItemQuantity | 1 | Item quantity |
11 | InvCustLinePH | 050-8XXXXXX | Cell number |
12 | InvCustNumber | 03-5XXXXXXX | Land line number |
13 | InvDepartmentId | Department code in Cardcom system | Department code on invoice |
14 | InvNoVat |
| Create vat free invoice |
15 | InvComments | Up to 250 characters | Comments for invoice |
16 | InvSendInvoiceByMail |
| Send invoice by email |
17 | InvLanguages | he=Hebrew, en=English | Invoice language |
18 | InvProductID | ID A1A2A3 | Item ID number for invoice |
Expanded parameters for invoice creation:
If parameter InvCreateInvoice=1 is sent it w ill always work according to the above chart.
Instead of using the above invoice parameters You can use standard parameters for invoice creation (according to guide - > Creating an invoice through API).
In that case you must send InvCreateInvoice=0 or not send anything.
Additionally, you can send parameter InvoiceType as the invoice type to create that will override the terminal's default.
Only if the deal was successful an invoice will be created.
Returning response details:
Number | Parameter | Possible values | Description |
1 | ResponseCode | 0 - good | Response code description |
2 | InternalDealNumber | 5643 | Unique internal deal number |
3 | Description | Deal was successful | Response description |
4 | ApprovalNumber |
| Deal approval number |
5 | InvoiceResponse.ResponseCode |
| Response code to create invoice |
6 | InvoiceResponse.Description |
| Response description |
7 | InvoiceResponse.InvoiceNumber |
| Created invoice number |
8 | InvoiceResponse.InvoiceType |
| Created invoice type |
9 | Token |
| Created token for card |
10 | Mutag_24 |
| Card brand |
11 | Sulac_25 |
| Credit card company number |
12 | First_Payment_Sum_78 |
| First payment |
13 | Const_Patment_86 |
| Recurring payment |
14 | IsEMV |
| EMV deal? |
15 | Uid |
| EMV deal ID for credit card companies |
16 | Rrn |
| EMV deal ID for the credit card companies |
17 | BinId |
| Bin ID of card |
18 | IsJ2ChackIsValid |
| Is J2 check good? |
19 | Tokef_30 |
| Card expiry |
20 | CardNumStart |
| Beginning of card number |
21 | CardNumEnd |
| End of card number |
Web Service Interface:
You can clear a card through Web Service - Interface address: https://secure.cardcom.co.il/service.asmx
Must use function: PerfromBillVerySimple
Parameters chart:
Number | Parameter | Possible values | Description |
1 | TerminalNumber | 1000 | Charging terminal |
2 | UserName | barak9611 | User name |
3 | SumToBill | 15 | Charge sum |
4 | CardValidityMonth | 12 | Card month |
5 | CardValidityYear | 26 | Card year |
6 | CardNumber | 4580000000000000000 | Card number |
Additionally - we receive responses from the credit card companies. you can view them here - Parameters chart
Returning response details:
Number | Parameter | Possible values | Description |
1 | ResponseCode | 0 - good | Response code description |
2 | InternalDeal | 5643 | Unique internal deal ID number |
3 | Description | Deal was successful | Returned response description |
Important: during work with direct debit there is no option to get a PCI certificate form cardcom.
You must acquire it yourself from the credit card company. You must NOT keep the card details including CVV but only send them through the interface.
You can download example code for developers who don't want to work with tokens and want to create suspended deal through direct debit and charge it in the Cardcom interface.
You can use example code SuspendedDealDeposit below (Tokens are better for flexibility)