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	email	[e-mail]	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  View full list	Currency code for invoice. Must be the same as charge currency
6	invCustName	Eli Cohen ltd	Client's name on the invoice
7	invDestEmail	[e-mail]	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)

• Direct2.txt