Z-Credit Web Service Design Version Control Box

Transcription

Z-Credit Web Service Design Version Control Box
Title:
Z-Credit Web Service
Design
Author:
Authority:
Z-Credit
Classification:
Internal Document - Company In-Confidence
Version Control Box
Please update the latest Version No in the footer as well.
Version
Date
1.0
1.0
1.1
1.2
1.3
22/09/09
5/11/09
09/11/09
12/11/09
15/11/09
Description of change
Initial Document
Updated samples and instuctions
Added the password field for WS functions
Added the GetCustomReportData
Added the CommitSimplePaymentsTransaction function
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 1 of 13
Version:
November 14, 2009
Table of Content
1. GENERAL................................................................................................................................................................................. 3
2. SECURITY................................................................................................................................................................................ 3
3. WEB SERVICE DESCRIPTION............................................................................................................................................ 3
4. WEB SERVICE FUNCTIONS ................................................................................................................................................ 4
4.1
4.2
4.3
4.4
4.5
4.6
COMMITFULLTRANSACTION...................................................................................................................................................... 4
COMMITSIMPLETRANSACTION .................................................................................................................................................. 5
COMMITSIMPLEPAYMENTSTRANSACTION ................................................................................................................................. 5
VALIDATECARD ........................................................................................................................................................................ 6
GETREPORTDATA...................................................................................................................................................................... 6
GETCUSTOMREPORTDATA ........................................................................................................................................................ 7
5. PARAMETERS LEGEND....................................................................................................................................................... 8
6. CODE EXAMPLES................................................................................................................................................................ 10
6.1
6.2
6.3
ASP.NET USAGE SAMPLE......................................................................................................................................................... 10
ASP USAGE SAMPLE ................................................................................................................................................................ 10
PHP USAGE SAMPLE ............................................................................................................................................................... 10
7. TESTING INSTRUCTIONS: ................................................................................................................................................ 10
8. GUI BUILD INSTRUCTIONS:............................................................................................................................................. 10
9. APPENDIX A – SHVA ERROR CODES:............................................................................................................................ 11
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 2 of 13
Version:
November 14, 2009
1. GENERAL
The main purpose of the this document is to describe the usage of the Z-Credit's Web Service.
The web service is located at :
https://www.zcredit.co.il/ZCreditWS.asmx
2. SECURITY
Only authenticated IP addresses can access this URI.
Sender of the request, must use SSL encryption.
Every terminal is assign a username and a password.
The production database is not accessible through an internet connection.
No sensitive credit cards data is saved!
3. WEB SERVICE DESCRIPTION
When Accessing the URI of the web service you should get this screen :
Click on each row to get the function documentation, and the XML that constructs it.
For example, the ValidateCard function contains this XML commands:
POST /ZCreditWS.asmx HTTP/1.1
Host: localhost
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<ValidateCard xmlns="http://z-credit.com/">
<TerminalNumber>string</TerminalNumber>
<Password>string</Password>
<Track2>string</Track2>
<CardNumber>string</CardNumber>
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 3 of 13
Version:
November 14, 2009
<ExpDate_MMYY>string</ExpDate_MMYY>
</ValidateCard>
</soap12:Body>
</soap12:Envelope>
4. WEB SERVICE FUNCTIONS
4.1
CommitFullTransaction
This is the main function. this function allows all of the needed features for credit card transaction.
public bool CommitFullTransaction(string TerminalNumber,
string Password,
string Track2,
ref string CardNumber,
ref string ExpDate_MMYY,
float TransactionSum,
int NumOfPayments,
float FirstPaymentSum,
float OtherPaymentsSum,
bool IsRefund,
int CurrencyType,
int CreditType,
int J,
bool IsPointsTransaction,
float PointsSum,
string PhoneNumber,
string HolderID,
string CVV,
bool IsCustomerPresent,
string ExtraData,
string CustomerName,
string CustomerAddress,
string CreditClubID,
ref string AuthNum,
out int Validation_Result_Code,
out string Validation_Result_Message,
out string CardName,
out string CardIssuerCode,
out string CardFinancerCode,
out string CardBrandCode,
out int ReferenceNumber,
out string VoucherNumber,
out string ApprovalType)
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 4 of 13
Version:
November 14, 2009
4.2
CommitSimpleTransaction
This function allows a simple credit card transaction, without extra parameters for simple use
public bool CommitSimpleTransaction(string TerminalNumber,
string Password,
string Track2,
ref string CardNumber,
ref string ExpDate_MMYY,
float TransactionSum,
string HolderID,
string CVV,
bool IsCustomerPresent,
ref string AuthNum,
out int Validation_Result_Code,
out string Validation_Result_Message,
out string CardName,
out string CardIssuerCode,
out string CardFinancerCode,
out string CardBrandCode,
out int ReferenceNumber,
out string VoucherNumber,
out string ApprovalType)
4.3
CommitSimplePaymentsTransaction
This function allows a simple credit card transaction, with payments (installments)
public bool CommitSimplePaymentsTransaction(string TerminalNumber,
string Password,
string Track2,
ref string CardNumber,
ref string ExpDate_MMYY,
float TransactionSum,
int NumOfPayments,
float FirstPaymentSum,
float OtherPaymentsSum,
string HolderID,
string CVV,
bool IsCustomerPresent,
ref string AuthNum,
out int Validation_Result_Code,
out string Validation_Result_Message,
out string CardName,
out string CardIssuerCode,
out string CardFinancerCode,
out string CardBrandCode,
out int ReferenceNumber,
out string VoucherNumber,
out string ApprovalType)
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 5 of 13
Version:
November 14, 2009
4.4
ValidateCard
This function is used for credit card validation, before committing an actual transaction (Knows as J2)
public bool ValidateCard(string TerminalNumber,
string Password,
string Track2,
ref string CardNumber,
ref string ExpDate_MMYY,
out int Validation_Result_Code,
out string Validation_Result_Message,
out string CardName)
4.5
GetReportData
This function is used to extract data from the transactions history database. you can pass needed info and the
function will filter transactions as requested.
public bool GetReportData(int TransactionsSource,
string TerminalNumber,
string Password,
string CardNumber_Last4Digits,
string From_TransactionDate_DDmmYYHHMMSS,
string To_TransactionDate_DDmmYYHHMMSS,
string From_TransactionSum,
string To_TransactionSum,
string HolderID,
string ShvaAuthNumber,
string InternalReferenceNumber,
string CardIssuerCode,
string CardFinancerCode,
string TransactionType,
string NumberOfPayments,
bool RefundsOnly,
out int Validation_Result_Code,
out string Validation_Result_Message,
out string XmlDataResponse)
*Note - TransactionsSource :
1 = Approved transactions (J0)
2 = Logged transactions and failures (J2,J5,Failures)
Here is a sample of a return dataset value from the parameter: XmlDataResponse
<NewDataSet>
<Table>
<InternalNumber>4</InternalNumber>
<CardNumber>0000</CardNumber>
<ExpDate>01/10</ExpDate>
<TransactionSum>4.34</TransactionSum>
<CreditType>1</CreditType>
<NumOfPayments>0</NumOfPayments>
<FirstPayment>0</FirstPayment>
<OtherPayments>0</OtherPayments>
<ShvaAuthNum>0000000</ShvaAuthNum>
<HolderID />
<TransactionDate>2009-09-30T00:20:06-07:00</TransactionDate>
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 6 of 13
Version:
November 14, 2009
<J>0</J>
<CardIssuerCode>2</CardIssuerCode>
<CardFinancerCode>2</CardFinancerCode>
<CardName>((‫ ויזה‬Cal</CardName>
<DepositID>8925378</DepositID>
</Table>
<Table>
<InternalNumber>5</InternalNumber>
<CardNumber>0000</CardNumber>
<ExpDate>01/10</ExpDate>
<TransactionSum>2.14</TransactionSum>
<CreditType>1</CreditType>
<NumOfPayments>0</NumOfPayments>
<FirstPayment>0</FirstPayment>
<OtherPayments>0</OtherPayments>
<ShvaAuthNum>0000000</ShvaAuthNum>
<HolderID />
<TransactionDate>2009-09-30T00:23:08-07:00</TransactionDate>
<J>0</J>
<CardIssuerCode>2</CardIssuerCode>
<CardFinancerCode>2</CardFinancerCode>
<CardName>((‫ ויזה‬Cal</CardName>
<DepositID>8925378</DepositID>
</Table>
</NewDataSet>
4.6
GetCustomReportData
This function is used to extract specific data from the transactions history database, when given the needed.
public bool GetCustomReportData(int ReportNumber,
string TerminalNumber,
string Password,
string From_TransactionDate_DDmmYYHHMMSS,
string To_TransactionDate_DDmmYYHHMMSS,
out int Validation_Result_Code,
out string Validation_Result_Message,
out string XmlDataResponse)
ReportNumber Legend:
1. Get the Amount/Sum of the transactions, aggregated per month.
2. Get the Amount/Sum of the transactions, aggregated per Daily Hour.
3. Get the Amount/Sum of the transactions, aggregated per Card Issuer ('‫דיינרס וכו‬.‫ישראכרט‬.‫)ויזה‬.
4. Get the Amount/Sum of the transactions, aggregated per Deal Type (‫קרדיט‬.‫תשלומים‬.‫)רגיל‬.
5. Get the Amount/Sum of the transactions, aggregated per Currency Type (‫דולר‬.‫)ש"ח‬.
6. Get the Amount/Sum + credit/debit separation of the transactions, aggregated per Day
the XML with the results will be return in XmlDataResponse.
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 7 of 13
Version:
November 14, 2009
5. PARAMETERS LEGEND




























TerminalNumber – As assigned by Z-Credit
Password – As assigned by Z-Credit
Track2 - The data received from the MSR (card reader) , is one is used. (If not used fill "")
CardNumber – Credit card number, if entered manually. (If not used fill "")
ExpDate_MMYY - Needed only for manual card number entry. Format : MMYY (FE: 1012)
TransactionSum – The total sum of the transaction. (decimal format)
NumOfPayments - If this is a payments transaction (AKA: installment transaction), this parameter is the number of payments. If this
is not a payments transaction , NumOfPayments = 0
FirstPaymentSum = First payment sum. If this is not a payment transaction, FirstPaymentSum = 0
Please see the payments division instructions bellow
OtherPaymentsSum = Sum of the other equal payments. If this is not a payment transaction, OtherPaymentsSum = 0
IsRefund - True = This is a refund transaction, False = This is a regular transaction
CurrencyType - 1 = NIS , 2 = USD , 4 = USD payments, 8 = Index-Linked Payments
CreditType 
1 = ‫רגיל‬

2 = ‫ ישראכרדיט‬/ +30

3 = ‫חיוב מיידי‬

4 = ‫מועדון‬

5 = ‫סופר קרדיט‬

6 = ‫קרדיט‬

8 = ‫תשלומים‬

9 = ‫מועדון בתשלומים‬
J
0 = Regular transaction

2 = Check card only

5 = ‫שובר ביטחון‬
(Please do not use other numbers)
IsPointsTransaction - If this transaction is a ‫נקודות‬/‫ כוכבים‬, Send "True"
PointsSum - Only if " IsPointsTransction = True" , contains the points sum.
HolderID - ‫ז‬.‫מספר ת‬
CVV - 3 or 4 CVV digits at the back of the credit card
IsCustomerPresent - Send "True" if the Customer is present and can sign the transaction documents.
ExtraData – extra information of inner documentation.
CustomerName – the customer's name, of inner documentation.
CustomerAddress – the customer's name, of inner documentation.
CreditClubID - ‫מספר מועדון עבור אשראי מסוג מועדון‬
AuthNum - If is empty, Is will be returned after the transaction is approved.

0 = transaction approved with no transmission (usually small amounts)

XXXX = transaction approved with the credit card company

If an 3,4,6,9 error is received, you can get an approval by calling your credit company. then resend the transaction
with this number and it will be registered.
Validation_Result_Code - Function result code for the transaction. (Shva codes). Please see Appendix A
Validation_Result_Message - Function result message for display (given by shva) , Appendix A
CardName - This is the customer's credit card name for printing on the slip.
CardIssuerCode - Issuer Code as listed:
 1 = ‫ישראכרט‬
 2 = ‫ויזה‬
 3 = ‫דיינרס‬
 4 = ‫אמריקן אקספרס‬
 5 = JCB
 6 = ‫לאומי קארד‬
CardFinancerCode - Financer Code (same as issuer code list)
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 8 of 13
Version:
November 14, 2009




CardBrandCode – Not is use…
ReferenceNumber – Unique reference number, for identifying transactions later on.
VoucherNumber – Voucher number for slip printing, given by shva.
ApprovalType – Approval type for slip printing, given by shva.
Payments Division Instructions:
In general you can divide the TransactionSum/ NumOfPayments and cut the result to 2
decimal digits. Then you take the reminder of the division, and add it to the
FirstPaymentSum sum.
This must occur : ((NumOfPayments – 1)* OtherPaymentsSum) + FirstPaymentSum = TransactionSum
The FirstPaymentSum actually is meant for overloading the differences when the
TransactionSum/ NumOfPayments does not divide equally.
Here is an example.
TransactionSum = 40
NumOfPayments = 6
In this case:
FirstPaymentSum = 6.7
OtherPaymentsSum = 6.66
So that : (5*6.66) + 6.7 = 40
Except for the Shva Error codes as describes in Appendix A , There are inner error codes.
Inner Error Codes:
Code
-1 to -20
Meaning
Terminal identification Errors
-21
Error Saving Data
-22
Error Running transaction process
-96
-97
Security Error
Input Error
-98
Web service execution error
-99
Unexpected Error
-100
Unexpected Shva Error
Other
Credit Card Company Codes (Code>0)
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Action Needed
Please read the returned error message for details
about the cause of the error.
Critical Error! Contact customer support for further
information
Critical Error! Contact customer support for further
information
Run your request through a secure connection.
One or more of the parameters sent to the WS, are not
in the valid format. F.E: letters was send to the
"TerminalNumber" parameter.
Note: Special characters are not allowed! only
letters and numbers.
Critical Error! Error executing the web service
process. Contact customer support for further
information
Critical Error! Contact customer support for further
information.
Critical Error! Contact customer support for further
information.
Please see Appendix A
Page 9 of 13
Version:
November 14, 2009
6. CODE EXAMPLES
6.1
Asp.Net Usage Sample
Just add a web reference to the asmx file.
6.2
Asp Usage Sample
Please contact as for sample source code
6.3
PHP Usage Sample
Please contact as for sample source code
7. TESTING INSTRUCTIONS:
For testing the web service please use:
Terminal Number : 0963222014
Card Number : 4580000000000000
Call the web service from an SSL protected page. Unsecured connection is not allowed.
8. GUI BUILD INSTRUCTIONS:





When using a card reader (MSR) :
o After a card is swiped, save the Full Swipe Data .
o Call "ValidateCard" with the swipe data, and you will receive:
 Card Number
 Validity Date
o Show these new values to the customer, and hide the swipe data entry (must not be shown)
o When the transaction is sent, you must send the Full Swipe Data. (in the cardNum fields)
When entering a manual card data
o You can call the "ValidateCard" to get the cardName. But it's not mandatory…
User cannot enter a manual "Approval Number", unless a return value of 3,4,6,9 was received.
An equal Payments division should be made. If the payments do not divide equally, the first payment should
contain the difference.
CreditType: 5,6,8,9 should ask for payments Number. Only 5,6 should allow to manipulate the first payment
data.
 Z-Credit
Reference: ZZ_100_1098
From: RnD
Z-Credit_WS_1.3_.doc
Page 10 of 13
Version:
November 14, 2009
‫‪9. APPENDIX A – SHVA ERROR CODES:‬‬
‫‪000‬‬
‫‪001‬‬
‫‪002‬‬
‫‪003‬‬
‫‪004‬‬
‫‪005‬‬
‫‪006‬‬
‫‪007‬‬
‫‪008‬‬
‫‪009‬‬
‫‪010‬‬
‫‪015‬‬
‫‪016‬‬
‫‪017‬‬
‫‪019‬‬
‫‪020‬‬
‫‪021‬‬
‫‪022‬‬
‫‪023‬‬
‫‪024‬‬
‫‪025‬‬
‫‪026‬‬
‫‪027‬‬
‫‪028‬‬
‫‪029‬‬
‫‪030‬‬
‫‪031‬‬
‫‪032‬‬
‫‪033‬‬
‫‪034‬‬
‫‪035‬‬
‫‪036‬‬
‫‪037‬‬
‫‪038‬‬
‫‪039‬‬
‫‪040‬‬
‫‪041‬‬
‫‪042‬‬
‫‪043‬‬
‫‪044‬‬
‫‪045‬‬
‫‪046‬‬
‫‪047‬‬
‫‪051‬‬
‫‪052‬‬
‫‪053‬‬
‫‪057‬‬
‫‪058‬‬
‫‪059‬‬
‫‪060‬‬
‫‪061‬‬
‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫–‬
‫‬‫–‬
‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‪-‬‬
‫עסקה תקינה‪.‬‬
‫חסום ‪.‬‬
‫גנוב ‪.‬‬
‫התקשר לחברת האשראי‪.‬‬
‫סירוב‪.‬‬
‫מזויף ‪.‬‬
‫ת‪.‬ז‪ .‬או ‪ CVV‬שגויים‪.‬‬
‫‪ ECI‬או ‪ UCAF/CAVV‬שגויים‪.‬‬
‫תקלה בבניית מפתח גישה לקובץ חסומים‪.‬‬
‫לא הצליח להתקשר‪ ,‬התקשר לחברת האשראי‪.‬‬
‫תוכנית הופסקה עפ"י הוראת המפעיל )‪ (ESC‬או ‪ COM PORT‬לא ניתן לפתיחה )‪.(WINDOWS‬‬
‫אין התאמה בין המספר שהוקלד לפס המגנטי‪.‬‬
‫נתונים נוספים אינם או ישנם בניגוד להגדרות המסוף ‪.‬‬
‫לא הוקלדו ‪ 4‬ספרות האחרונות‪.‬‬
‫רשומה בקובץ ‪ INT_IN‬קצרה מ‪ 16 -‬תווים‪.‬‬
‫קובץ קלט )‪ (INT_IN‬לא קיים‪.‬‬
‫קובץ חסומים )‪ (NEG‬לא קיים או לא מעודכן ‪ -‬בצע שידור או בקשה לאישור עבור כל עסקה‪.‬‬
‫אחד מקבצי פרמטרים או ווקטורים לא קיים‪.‬‬
‫קובץ תאריכים )‪ (DATA‬לא קיים‪.‬‬
‫קובץ אתחול )‪ (START‬לא קיים‪.‬‬
‫הפרש בימים בקליטת חסומים גדול מדי ‪-‬בצע שידור או בקשה לאישור עבור כל עסקה‪.‬‬
‫הפרש דורות בקליטת חסומים גדול מידי – בצע שידור או בקשה לאישור עבור כל עסקה‪.‬‬
‫כאשר לא הוכנס פס מגנטי כולו הגדר עסקה כעסקה טלפונית או כעסקת חתימה בלבד‪.‬‬
‫מספר מסוף מרכזי לא הוכנס למסוף המוגדר לעבודה כרב ספק‪.‬‬
‫מספר מוטב לא הוכנס למסוף המוגדר לעבודה כרב מוטב‪.‬‬
‫מסוף שאינו מעודכן כרב ספק‪/‬רב מוטב והוקלד מס' ספק‪/‬מס' מוטב‪.‬‬
‫מסוף מעודכן כרב ספק והוקלד גם מס' מוטב‪.‬‬
‫תנועות ישנות בצע שידור או בקשה לאישור עבור כל עסקה‪.‬‬
‫כרטיס לא תקין‪.‬‬
‫כרטיס לא רשאי לבצע במסוף זה או אין אישור לעסקה כזאת‪.‬‬
‫כרטיס לא רשאי לבצע עסקה עם סוג אשראי זה‪.‬‬
‫פג תוקף‪.‬‬
‫שגיאה בתשלומים ‪ -‬סכום עסקה צריך להיות שווה תשלום ראשון ‪) +‬תשלום קבוע כפול מס' תשלומים(‬
‫לא ניתן לבצע עסקה מעל תקרה לכרטיס לאשראי חיוב מיידי‪.‬‬
‫סיפרת בקורת לא תקינה‪.‬‬
‫מסוף שמוגדר כרב מוטב הוקלד מס' ספק‪.‬‬
‫מעל תקרה‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪( J1,J2,J3‬‬
‫חסום בספק‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪( J1,J2,J3‬‬
‫אקראית‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪( J1,J2,J3‬‬
‫מסוף לא רשאי לבקש אישור ללא עסקה‪ ,‬אך קובץ הקלט מכיל )‪.(J5‬‬
‫מסוף לא רשאי לבקש אישור ביוזמתו‪ ,‬אך קובץ הקלט מכיל )‪.(J6‬‬
‫יש לבקש אישור‪ ,‬אך קובץ הקלט מכיל הוראה לא לבצע שאילתא )‪( J1,J2,J3‬‬
‫יש לבקש אישור בשל בעיה הקשורה לקכ"ח אך קובץ הקלט מכיל הוראה לא לבצע שאילתא‪.‬‬
‫מספר רכב לא תקין‪.‬‬
‫מד מרחק לא הוקלד‪.‬‬
‫מסוף לא מוגדר כתחנת דלק‪) .‬הועבר כרטיס דלק או קוד עסקה לא מתאים(‬
‫לא הוקלד מספר תעודת זהות‪.‬‬
‫לא הוקלד ‪. CVV2‬‬
‫לא הוקלדו מספר תעודת הזהות וה‪. CVV2 -‬‬
‫צרוף ‪ ABS‬לא נמצא בהתחלת נתוני קלט בזיכרון‪.‬‬
‫מספר כרטיס לא נמצא או נמצא פעמיים‪.‬‬
‫‪Page 11 of 13‬‬
‫‪November 14, 2009‬‬
‫‪Version:‬‬
‫‪Reference: ZZ_100_1098‬‬
‫‪ Z-Credit‬‬
‫‪Z-Credit_WS_1.3_.doc‬‬
‫‪From: RnD‬‬
‫‪062‬‬
‫‪063‬‬
‫‪064‬‬
‫‪065‬‬
‫‪066‬‬
‫‪067‬‬
‫‪068‬‬
‫‪069‬‬
‫‪070‬‬
‫‪071‬‬
‫‪072‬‬
‫‪073‬‬
‫‪074‬‬
‫‪075‬‬
‫‪076‬‬
‫‪077‬‬
‫‪080‬‬
‫‪099‬‬
‫‪101‬‬
‫‪106‬‬
‫‪107‬‬
‫‪108‬‬
‫‪109‬‬
‫‪110‬‬
‫‪111‬‬
‫‪112‬‬
‫‪113‬‬
‫‪114‬‬
‫‪115‬‬
‫‪116‬‬
‫‪117‬‬
‫‪118‬‬
‫‪119‬‬
‫‪120‬‬
‫‪121‬‬
‫‪122‬‬
‫‪123‬‬
‫‪124‬‬
‫‪125‬‬
‫‪126‬‬
‫‪127‬‬
‫‪128‬‬
‫‪129‬‬
‫‪130‬‬
‫‪131‬‬
‫‪132‬‬
‫‪133‬‬
‫‪134‬‬
‫‪135‬‬
‫‪136‬‬
‫‪137‬‬
‫‪138‬‬
‫‪139‬‬
‫‪140‬‬
‫‪141‬‬
‫‪142‬‬
‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‪-‬‬
‫סוג עסקה לא תקין‪.‬‬
‫קוד עסקה לא תקין‪.‬‬
‫סוג אשראי לא תקין‪.‬‬
‫מטבע לא תקין‪.‬‬
‫קיים תשלום ראשון ו‪/‬או תשלום קבוע לסוג אשראי שונה מתשלומים‪.‬‬
‫קיים מספר תשלומים לסוג אשראי שאינו דורש זה‪.‬‬
‫לא ניתן להצמיד לדולר או למדד לסוג אשראי שונה מתשלומים‪.‬‬
‫אורך הפס המגנטי קצר מידי‪.‬‬
‫לא מוגדר מכשיר להקשת מספר סודי‪.‬‬
‫חובה להקליד מספר סודי‪.‬‬
‫קכ"ח לא זמין – העבר בקורא מגנטי‪.‬‬
‫הכרטיס נושא שבב ויש להעבירו דרך הקכ"ח‪.‬‬
‫דחייה – כרטיס נעול‪.‬‬
‫דחייה – פעולה עם קכ"ח לא הסתיימה בזמן הראוי‪.‬‬
‫דחייה – נתונים אשר התקבלו מקכ"ח אינם מוגדרים במערכת‪.‬‬
‫הוקש מספר סודי שגוי‬
‫הוכנס "קוד מועדון" לסוג אשראי לא מתאים‪.‬‬
‫לא מצליח לקרוא‪ /‬לכתוב‪ /‬לפתוח קובץ ‪.TRAN‬‬
‫אין אישור מחברת אשראי לעבודה‪.‬‬
‫למסוף אין אישור לביצוע שאילתא לאשראי חיוב מיידי‪.‬‬
‫סכום העסקה גדול מידי – חלק למספר העסקאות‪.‬‬
‫למסוף אין אישור לבצע עסקאות מאולצות‪.‬‬
‫למסוף אין אישור לכרטיס עם קוד השרות ‪.587‬‬
‫למסוף אין אישור לכרטיס חיוב מיידי‪.‬‬
‫למסוף אין אישור לעסקה בתשלומים‪.‬‬
‫למסוף אין אישור לעסקה טלפון‪ /‬חתימה בלבד בתשלומים‪.‬‬
‫למסוף אין אישור לעסקה טלפונית‪.‬‬
‫למסוף אין אישור לעסקה "חתימה בלבד"‪.‬‬
‫למסוף אין אישור לעסקאות במטבע זר או עסקה לא מאושרת‪.‬‬
‫למסוף אין אישור לעסקת מועדון‪.‬‬
‫למסוף אין אישור לעסקת כוכבים‪/‬נקודות‪/‬מיילים‪.‬‬
‫למסוף אין אישור לאשראי ישראקרדיט‪.‬‬
‫למסוף אין אישור לאשראי אמקס קרדיט‪.‬‬
‫למסוף אין אישור להצמדה לדולר‪.‬‬
‫למסוף אין אישור להצמדה למדד‪.‬‬
‫למסוף אין אישור להצמדה למדד לכרטיסי חו"ל‪.‬‬
‫למסוף אין אישור לעסקת כוכבים‪/‬נקודות‪/‬מיילים לסוג אשראי זה‪.‬‬
‫למסוף אין אישור לאשראי קרדיט בתשלומים לכרטיסי ישראכרט‬
‫למסוף איו אישור לאשראי קרדיט בתשלומים לכרטיסי אמקס‬
‫למסוף אין אישור לקוד מועדון זה‪.‬‬
‫למסוף אין אישור לעסקת חיוב מיידי פרט לכרטיסי חיוב מיידי‪.‬‬
‫למסוף אין אישור לקבל כרטיסי ויזה אשר מתחילים ב ‪.3 -‬‬
‫למסוף אין אישור לבצע עסקת זכות מעל תקרה‪.‬‬
‫כרטיס לא רשאי לבצע עסקת מועדון‪.‬‬
‫כרטיס לא רשאי לבצע עסקת כוכבים‪/‬נקודות‪/‬מיילים‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות בדולרים )רגילות או טלפוניות(‪.‬‬
‫כרטיס לא תקף על פי רשימת כרטיסים תקפים של ישראכרט‪.‬‬
‫כרטיס לא תקין עפ”י הגדרת המערכת )‪ VECTOR1‬של ישראכרט(‪ -‬מס' הספרות בכרטיס‪ -‬שגוי‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות דולריות עפ”י הגדרת המערכת )‪ VECTOR1‬של ישראכרט(‪.‬‬
‫הכרטיס שייך לקבוצת כרטיסים אשר אינה רשאית לבצע עסקאות עפ”י הגדרת המערכת )‬
‫‪ VECTOR20‬של ויזה(‪.‬‬
‫קידומת הכרטיס )‪ 7‬ספרות( לא תקפה עפ”י הגדרת המערכת )‪ VECTOR21‬של דיינרס(‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות בתשלומים על פי רשימת כרטיסים תקפים של ישראכרט‪.‬‬
‫מספר תשלומים גדול מידי על פי רשימת כרטיסים תקפים של ישראכרט‪.‬‬
‫כרטיסי ויזה ודיינרס לא רשאים לבצע עסקאות מועדון בתשלומים‪.‬‬
‫סידרת כרטיסים לא תקפה עפ”י הגדרת המערכת‪.‬‬
‫)‪ VECTOR5‬של ישראכרט(‪.‬‬
‫קוד שרות לא תקף עפ”י הגדרת המערכת )‪ VECTOR6‬של ישראכרט(‪.‬‬
‫‪Page 12 of 13‬‬
‫‪November 14, 2009‬‬
‫‪Version:‬‬
‫‪Reference: ZZ_100_1098‬‬
‫‪ Z-Credit‬‬
‫‪Z-Credit_WS_1.3_.doc‬‬
‫‪From: RnD‬‬
‫‪143‬‬
‫‪144‬‬
‫‪145‬‬
‫‪146‬‬
‫‪147‬‬
‫‪148‬‬
‫‪149‬‬
‫‪150‬‬
‫‪151‬‬
‫‪152‬‬
‫‪153‬‬
‫‪154‬‬
‫‪155‬‬
‫‪156‬‬
‫‪157‬‬
‫‪158‬‬
‫‪159‬‬
‫‪160‬‬
‫‪161‬‬
‫‪162‬‬
‫‪163‬‬
‫‪164‬‬
‫‪165‬‬
‫‪166‬‬
‫‪167‬‬
‫‪168‬‬
‫‪169‬‬
‫‪170‬‬
‫‪171‬‬
‫‪172‬‬
‫‪173‬‬
‫‪174‬‬
‫‪175‬‬
‫‪176‬‬
‫‪177‬‬
‫‪178‬‬
‫‪179‬‬
‫‪180‬‬
‫‪200‬‬
‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‬‫‪-‬‬
‫קידומת הכרטיס )‪ 2‬ספרות( לא תקפה עפ”י הגדרת המערכת‪ VECTOR7) .‬של ישראכרט(‪.‬‬
‫ויזה(‪.‬‬
‫קוד שרות לא תקף עפ”י הגדרת המערכת‪ VECTOR12) .‬של‬
‫קוד שרות לא תקף עפ”י הגדרת המערכת‪ VECTOR13) .‬של ויזה(‪.‬‬
‫לכרטיס חיוב מיידי אסור לבצע עסקת זכות‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות בתשלומים עפ"י וקטור ‪ 31‬של לאומיקארד‪.‬‬
‫בלבד עפ"י ווקטור ‪ 31‬של לאומיקארד‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות טלפוניות וחתימה‬
‫כרטיס אינו רשאי לבצע עסקאות טלפוניות עפ"י וקטור ‪ 31‬של לאומיקארד‪.‬‬
‫אשראי לא מאושר לכרטיסי חיוב מיידי‪.‬‬
‫אשראי לא מאושר לכרטיסי חו"ל‪.‬‬
‫קוד מועדון לא תקין‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות אשראי גמיש )עדיף ‪ (/30+‬עפ"י הגדרת המערכת‪ VECTOR21) .‬של דיינרס(‪.‬‬
‫כרטיס לא רשאי לבצע עסקאות חיוב מיידי עפ"י הגדרת המערכת‪ VECTOR21) .‬של דיינרס(‪.‬‬
‫סכום המינמלי לתשלום בעסקת קרדיט קטן מידי‪.‬‬
‫מספר תשלומים לעסקת קרדיט לא תקין‪.‬‬
‫תקרה ‪ 0‬לסוג כרטיס זה בעסקה עם אשראי רגיל או קרדיט‪.‬‬
‫מיידי‪.‬‬
‫תקרה ‪ 0‬לסוג כרטיס זה בעסקה עם אשראי חיוב‬
‫תקרה ‪ 0‬לסוג כרטיס זה בעסקת חיוב מיידי בדולרים‪.‬‬
‫תקרה ‪ 0‬לסוג כרטיס זה בעסקה טלפונית‪.‬‬
‫תקרה ‪ 0‬לסוג כרטיס זה בעסקת זכות‪.‬‬
‫תקרה ‪ 0‬לסוג כרטיס זה בעסקת תשלומים‪.‬‬
‫כרטיס אמריקן אקספרס אשר הונפק בחו"ל לא רשאי לבצע עסקאות בתשלומים‪.‬‬
‫כרטיסי‪ JCB‬רשאי לבצע עסקאות רק באשראי רגיל‪.‬‬
‫סכום בכוכבים‪/‬נקודות‪/‬מיילים גדול מסכום העסקה‪.‬‬
‫כרטיס מועדון לא בתחום של המסוף‪.‬‬
‫לא ניתן לבצע עסקת כוכבים‪/‬נקודות‪/‬מיילים בדולרים‪.‬‬
‫למסוף אין אישור לעסקה דולרית עם סוג אשראי זה‪.‬‬
‫לא ניתן לבצע עסקת זכות עם אשראי שונה מהרגיל‬
‫סכום הנחה בכוכבים‪/‬נקודות‪/‬מיילים גדול מהמותר‪.‬‬
‫לא ניתן לבצע עסקה מאולצת לכרטיס‪/‬אשראי חיוב מיידי‪.‬‬
‫לא ניתן לבטל עסקה קודמת )עסקת זכות או מספר כרטיס אינו זהה(‪.‬‬
‫עסקה כפולה‪.‬‬
‫למסוף אין אישור להצמדה למדד לאשראי זה‪.‬‬
‫למסוף אין אישור להצמדה לדולר לאשראי זה‪.‬‬
‫כרטיס אינו תקף עפ”י הגדרת ה מערכת )וקטור ‪ 1‬של ישראכרט(‪.‬‬
‫בתחנות דלק לא ניתן לבצע "שרות עצמי" אלא "שרות עצמי בתחנות דלק"‪.‬‬
‫אסור לבצע עסקת זכות בכוכבים‪/‬נקודות‪/‬מיילים‪.‬‬
‫אסור לבצע עסקת זכות בדולר בכרטיס תייר‪.‬‬
‫בכרטיס מועדון לא ניתן לבצע עסקה טלפונית‪.‬‬
‫שגיאה יישומית‪.‬‬
‫שגיאות מיוחדת ל ‪Web Service‬‬
‫בעיית זיהוי )מספר מסוף‪/‬שם משתמש‪/‬סיסמה לא תקינים(‪.‬‬
‫‬‫‪250‬‬
‫תקלה כללית‪ .‬יש לפנות לשב"א‪.‬‬
‫‬‫‪255‬‬
‫מספר עסקה אינו ייחודי עבור תאריך עסקה‪.‬‬
‫‬‫‪256‬‬
‫לא נמצא מידע נדרש‪.‬‬
‫‬‫‪257‬‬
‫אחד הפרמטרים לא תקינים )בדר"כ ערך אלפאנומרי היכן שצריך לקבל נומרי(‪.‬‬
‫‬‫‪260‬‬
‫‬‫‪280‬‬
‫‪) Time Out‬יותר מדקה לתשובה(‪.‬‬
‫נסיון לעבודה על מסוף ייצור בסביבת טסט‪.‬‬
‫‬‫‪298‬‬
‫‪Page 13 of 13‬‬
‫‪November 14, 2009‬‬
‫‪Version:‬‬
‫‪Reference: ZZ_100_1098‬‬
‫‪ Z-Credit‬‬
‫‪Z-Credit_WS_1.3_.doc‬‬
‫‪From: RnD‬‬