| Currency
Codes
Saferpay uses ISO 4217 currency codes to identify transaction currency. The
following currencies are currently supported, but not every provider is capable
of treating every currency. Please contact your local distributor to receive a
list of supported currencies for your country.
|
Currency Code |
Description |
|
CHF |
Switzerland, Schweizer Franken |
|
CZK |
Czechia, Czech Koruna |
|
DKK |
Danmark, Danish Krone |
|
EUR |
European Economic and Monetary Union (EMU), Euro |
|
GBP |
Great Britain, Pound Sterling |
|
PLN |
Poland, Polnische Zloty |
|
SEK |
Sweden, Swedish Krona |
|
USD |
United States, US Dollar |
Language Codes
The Saferpay Virtual Terminal supports different languages. The standard
language is German. To show the VT in a different language you have to specify
the LangId Attribute in the PayInit Message.
The following languages are currently supported:
|
Language Code |
Description |
|
en |
English |
|
de |
German |
|
fr |
French |
|
it |
Italian |
Time and Date Formats
Time and Date Formats are represented in a language indifferent manner.
Therefore time and date are always in GMT+1 (Europe/Zurich). The format is
defined as follows:
YYYYMMDDhhmmss
Example
The 3. January 2001, 11:40:21 PM is displayed as follows:
20010103234021
Result Codes
|
Value |
Name |
Description |
|
0 |
Authorization Successful |
|
|
5 |
Access Denied |
The access to the specified
account was denied by Saferpay. |
|
21 |
Invalid Structure |
Invalid structure of
request. |
|
22 |
Unknown Action |
Unknown action
attribute. |
|
23 |
Invalid Action |
Invalid action attribute or
action not possible. |
|
61 |
Invalid Card |
The static checks failed on
this card (range check, LUHN check digit). |
|
62 |
Invalid Date |
Invalid expiration
date. |
|
63 |
Card Expired |
The card has
expired. |
|
64 |
Unknown Card |
The card type is unknown, the
BIN range could not be assigned to a known card brand. |
|
65 |
Authorization Denied |
The processor has denied the
transaction request. |
|
67 |
No Contract |
No contract exists for the
card/currency combination specified. |
|
68 |
Ambigous Contract |
More than one contracts exist
for the specified card/currency combination. |
|
75 |
Missing Parameter |
One or more mandatory
parameters are missing |
|
76 |
Connect Failed |
The connection to the card
processor could not be established or was broken during the request.
Retry the request. |
|
77 |
No Endpoint |
No endpoint is specified for
the processor of the card. This processor may not support online
authorization of cards. |
|
78 |
Internal Error |
A system error has occurred
during processing the request. Retry the request if possible. |
|
80 |
No Terminal |
Terminal does not
exist. |
|
82 |
Not Found |
Transaction not
found. |
|
83 |
Invalid Currency |
The specified currency code is
invalid. |
|
84 |
Invalid Amount |
The specified amout is invalid
or does not match the rules for the currency. |
|
87 |
Prevalidate Denied |
Access denied. |
|
88 |
Reservation Invalid |
Reservation invalid. |
|
89 |
Reservation Overbooked |
Amount of reservation
overbooked. |
|
90 |
Contract Disabled |
The contract for this card is
currently disabled. |
|
97 |
Already Captured |
Transaction already captured
(PayComplete) |
|
98 |
Invalid Signature |
Invalid signature |
|
102 |
Not Supported |
Function not supported by
provider. |
|
104 |
Denied Blacklist |
Card number in customer black
list. |
|
105 |
Denied Country |
Card number not in country BIN
range list. |
|
151 |
Timeout Response |
Timeout waiting on
authorization response.
Retry the request. |
|
152 |
Unknown Error |
Unknown (system)
error. |
|
301 |
Authentication Error |
An error happened during the
authentication request. The merchant application could choose to
- continue the payment without
authentication or
- ask customer for other
payment method or
- stop the
payment. |
Error Codes
This document contains all the error codes returned by the Saferpay
Application Components (SAC). The file idperrc.h shipped with the SAC contains
the codes. For error checking in the different programming languages, please see
the samples. Some error codes are operating system specific. All result
codes are returned in the HEX format.
|
Result Code |
#define |
Short description |
Description |
|
0x00000000 |
IDP_S_OK |
successful |
The operation was successful |
|
|
|
|
|
|
0x80040201 |
IDP_E_CONTEXT |
no context present |
Configuration path is not set; call MessageFactory.Open() |
|
0x80040202 |
IDP_E_FILE_NOT_FOUND |
file not found |
|
|
0x80040203 |
IDP_E_FILE_ERROR |
file I/O error |
|
|
0x80040204 |
IDP_E_INVALID_FILE |
invalid file format |
file does not contain valid XML content |
|
0x80040205 |
IDP_E_BUFFER_SIZE |
the buffer size is too small |
|
|
0x80040206 |
IDP_E_INVALID_URL |
invalid URL |
|
|
0x80040207 |
IDP_E_INVALID_OPTION |
invalid option |
invalid configuration option |
|
0x80040208 |
IDP_E_REQUEST_FAILED |
request failed |
|
|
0x80040209 |
IDP_E_CRYPT |
cryptographic error |
|
|
0x8004020a |
IDP_E_NO_ENDPOINT |
no endpoint |
Missing VTAUTOURL attribute in the "config.xml" file |
|
0x8004020b |
IDP_E_INVALID_KEYBLOB |
invalid key blob |
|
|
0x8004020c |
IDP_E_FAIL |
command failed |
|
|
0x8004020d |
IDP_E_NOT_FOUND |
requested item was not found |
|
|
0x8004020e |
IDP_E_NO_KEYID |
no key identifier specified |
Configuration path is not set or contains no valid key files, call
MessageFactory.Open() |
|
0x8004020f |
IDP_E_NO_CONFIG |
no configuration found |
Missing files in the configuration path, reconfigure Saferay |
|
0x80040210 |
IDP_E_KEY_NOT_FOUND |
the requested key was not found |
|
|
0x80040211 |
IDP_E_UNEXPECTED |
unexpected error |
|
|
0x80040212 |
IDP_E_NO_DEFAULT_PATH |
no default path was supplied |
|
|
0x80040213 |
IDP_E_REQUEST_ERROR |
the request failed |
|
|
0x80040214 |
IDP_E_VERIFY_FAILED |
invalid signature |
|
|
0x00040215 |
IDP_E_INVALID_DATE |
|
|
|
0x80040216 |
IDP_E_INVALID_HANDLE |
|
|
|
0x80040217 |
IDP_E_OUT_OF_MEMORY |
|
|
|
0x80040218 |
IDP_E_PARAMETER |
|
|
|
0x80040219 |
IDP_E_RESOURCE_NOT_FOUND |
|
config file was not found |
|
|
|
|
|
|
|
|
|
|
|
0x80042000 |
IDP_HTTP_BASE |
|
Last three digits represent the hexadecimal HTTP error |
|
0x80042019 |
IDP_HTTP_INVALID_URL |
|
|
|
0x80042020 |
IDP_HTTP_INVALID_PROTOCOL |
|
|
|
0x80042021 |
IDP_HTTP_DNS_ERROR |
|
|
|
0x80042022 |
IDP_HTTP_INVALID_RESPONSE |
|
|
|
0x80042023 |
IDP_HTTP_INVALID_STATE |
|
|
|
0x80042fff |
IDP_HTTP_END |
|
|
|
|
|
|
|
|
|
|
|
|
|
0x80043000 |
IDP_SOCKET_BASE |
|
Last three digits represent the hexadecimal, operating system specific
socket error |
|
0x80043fff |
IDP_SOCKET_END |
|
|
|
|
|
|
|
|
|
|
|
|
|
0x80044000 |
IDP_SSL_BASE |
|
Last three digits represent the hexadecimal SSL error |
|
0x80044fff |
IDP_SSL_END |
|
|
|
|
|
|
|
|
urlmon.dll results: |
|
|
|
|
0x80070005 |
|
access to URL resource denied |
|
|
0x800c0005 |
|
URL resource not found |
|
|
0x800c0006 |
|
URL resource not found |
|
|
0x800c000c |
|
invalid URL request |
|
|
|
|
|
|
|
socket results: |
|
|
|
|
IDP_SOCKET_BASE + 61 |
|
connection refused |
|
|
IDP_SOCKET_BASE + 60 |
|
connection timeout |
|
|
IDP_SOCKET_BASE + 54 |
|
connection reset |
|
|
IDP_SOCKET_BASE + 53 |
|
connection aborted |
|
|
IDP_SOCKET_BASE + 51 |
|
network not reachable |
|
|
Windows specific: |
|
|
|
|
0x80070000 + XXXX |
See on the MSDN |
|
|
|
|
|
|
|
|
http: |
|
|
|
|
IDP_HTTP_DNS_ERROR |
|
DNS lookup failed |
|
|
IDP_HTTP_BASE + 401 |
|
access to URL resource denied |
|
|
IDP_HTTP_BASE + 404 |
|
URL resource not found |
|
|
IDP_HTTP_BASE + 503 |
|
server temporarily unavailable |
|
Saferpay Card-Provider
This file contains information about card processor identification codes
currently used by Saferpay. Testing providers are not listed.
| Name |
Provider Id |
Service |
| AirPlus Corporate Card |
486 |
GICC |
| AirPlus Corporate Card USD |
488 |
GICC |
| American Express CAR |
1 |
CARCDS |
| American Express CAR EUR |
112 |
CARCDS |
| American Express CAR USD |
57 |
CARCDS |
| American Express GICC |
77 |
GICC |
| American Express GICC CHF |
333 |
GICC |
| American Express GICC GBP |
303 |
GICC |
| American Express GICC USD |
156 |
GICC |
| American Express POS |
239 |
|
| Bonus Card CAR |
516 |
CARCDS |
| Bonus Card CAR 3C |
15 |
CARCDS |
| Bonus Card NSP |
454 |
CARCDS |
| Bonus Card POS |
452 |
|
| Diners Club CAR |
5 |
CARCDS |
| Diners Club CAR EUR |
205 |
CARCDS |
| Diners Club CAR USD |
181 |
CARCDS |
| Diners Club Citicorp |
81 |
GICC |
| Diners Club Citicorp CHF |
199 |
GICC |
| Diners Club Citicorp EUR |
179 |
GICC |
| Diners Club Citicorp GBP |
197 |
GICC |
| Diners Club Citicorp GBP |
334 |
GICC |
| Diners Club Citicorp USD |
245 |
GICC |
| Diners Club Citicorp USD |
195 |
GICC |
| Diners Club POS |
235 |
|
| eps Bank Austria Creditanstalt |
341 |
EPS |
| eps BAWAG P.S.K. Gruppe |
345 |
EPS |
| eps Erste Bank und Sparkassen |
343 |
EPS |
| eps Erste Bank und Sparkassen (T) |
357 |
EPS |
| eps Hypo Bankengruppe |
541 |
EPS |
| eps Raiffeisen |
344 |
EPS |
| eps Volksbanken |
542 |
EPS |
| eScore Adress Verification |
167 |
AV |
| eScore Adress Verification |
155 |
AV |
| Geschenkkarte EP2 |
415 |
ep2:ACQSUB |
| Geschenkkarte POS |
402 |
|
| InterCard LSV |
132 |
ZVT |
| IQA Adress Verification |
159 |
AV |
| JCB B+S ep2 (TKC) |
478 |
ep2:ACQSUB |
| JCB B+S GICC |
106 |
GICC |
| JCB B+S TRT3 CHF |
277 |
GICC |
| JCB CAR |
12 |
CARCDS |
| JCB POS |
253 |
|
| Lastschrift B+S |
352 |
ZVT |
| Maestro CH Aduno ep2 |
506 |
ep2:ACQSUB |
| Maestro CH B+S POS |
512 |
|
| Maestro CH Multipay ep2 |
332 |
ep2:ACQSUB |
| Maestro CH Multipay POS |
241 |
|
| Maestro CH. B+S ep2 (TKC) |
480 |
ep2:ACQSUB |
| Maestro Intl. Acredos |
535 |
ep2:ACQSUB |
| Maestro Intl. Aduno ep2 |
504 |
ep2:ACQSUB |
| Maestro Intl. B+S ep2 (TKC) |
474 |
ep2:ACQSUB |
| Maestro Intl. B+S POS |
514 |
|
| Maestro Intl. Multipay ep2 |
361 |
ep2:ACQSUB |
| Maestro Intl. Multipay POS |
249 |
|
| Maestro Intl. Streamline ep2 |
427 |
ep2:ACQSUB |
| Mastercard Acredos |
537 |
ep2:ACQSUB |
| MasterCard Aduno CAR |
100 |
CARCDS |
| MasterCard Aduno CAR EUR |
110 |
CARCDS |
| MasterCard Aduno CAR GBP |
327 |
CARCDS |
| MasterCard Aduno CAR USD |
108 |
CARCDS |
| MasterCard Aduno ep2 |
328 |
ep2:ACQSUB |
| MasterCard AirPlus |
141 |
GICC |
| MasterCard AirPlus GBP |
525 |
GICC |
| MasterCard AirPlus USD |
432 |
GICC |
| MasterCard B+S ep2 (Datatrans) |
379 |
ep2:ACQSUB |
| MasterCard B+S ep2 (TKC) |
472 |
ep2:ACQSUB |
| MasterCard B+S GICC |
104 |
GICC |
| MasterCard B+S GICC GBP |
227 |
GICC |
| MasterCard B+S GICC USD |
223 |
GICC |
| MasterCard B+S POS |
482 |
|
| MasterCard B+S SET |
163 |
SET/NETLIFE |
| MasterCard B+S TRT3 CHF |
273 |
GICC |
| MasterCard Citcorp SET |
166 |
SET/NETLIFE |
| MasterCard Citicorp |
79 |
GICC |
| MasterCard Citicorp CHF |
193 |
GICC |
| MasterCard Citicorp CHF |
255 |
GICC |
| MasterCard Citicorp DKK |
257 |
GICC |
| MasterCard Citicorp DKK |
207 |
GICC |
| MasterCard Citicorp EUR |
177 |
GICC |
| MasterCard Citicorp GBP |
189 |
GICC |
| MasterCard Citicorp GBP |
259 |
GICC |
| MasterCard Citicorp SEK |
261 |
GICC |
| MasterCard Citicorp SEK |
209 |
GICC |
| MasterCard Citicorp USD |
219 |
GICC |
| MasterCard Citicorp USD |
187 |
GICC |
| MasterCard ConCardis |
116 |
GICC |
| MasterCard ConCardis CHF |
120 |
GICC |
| MasterCard Concardis ep2 |
463 |
ep2:ACQSUB |
| MasterCard ConCardis SET |
153 |
SET/NETLIFE |
| MasterCard ConCardis USD |
148 |
GICC |
| MasterCard Multipay CAR |
2 |
CARCDS |
| MasterCard Multipay ep2 |
330 |
ep2:ACQSUB |
| MasterCard Multipay NSP |
324 |
CARCDS |
| MasterCard Multipay POS |
237 |
|
| MasterCard Multipay POS alt |
251 |
|
| MasterCard Multipay SET |
96 |
SET/NETLIFE |
| MasterCard OmniPay Postbank |
358 |
GICC |
| MasterCard Streamline ep2 |
423 |
ep2:ACQSUB |
| MC ConCardis CHF |
124 |
GICC |
| Mediamarkt EP2 |
413 |
ep2:ACQSUB |
| Mediamarkt POS |
393 |
|
| Multipay CAR |
400 |
CARCDS |
| myOne Card EP2 |
411 |
ep2:ACQSUB |
| myOne Card POS |
391 |
|
| myOne NSP |
444 |
CARCDS |
| Paybox |
147 |
PAYBOX |
| Paybox Test |
164 |
PAYBOX |
| Post Finance Yellownet |
384 |
PFYN |
| PostCard DebitDirect |
322 |
PCDD |
| Postcard SET |
173 |
SET/XPAY |
| Postcard SET alt |
88 |
SET/XPAY |
| PowerCard POS |
459 |
|
| Rechnung |
114 |
BILL |
| Reka-Card POS |
508 |
|
| Visa Acredos |
539 |
ep2:ACQSUB |
| VISA Aduno CAR CHF |
527 |
CARCDS |
| VISA Aduno CAR EUR |
531 |
CARCDS |
| VISA Aduno CAR USD |
529 |
CARCDS |
| VISA Aduno DEM |
135 |
CARCDS |
| VISA Aduno ep2 |
365 |
ep2:ACQSUB |
| VISA Aduno GBP |
133 |
CARCDS |
| VISA Aduno ITL |
143 |
CARCDS |
| VISA Aduno POS |
389 |
|
| VISA AirPlus |
139 |
GICC |
| VISA AirPlus GBP |
523 |
GICC |
| VISA AirPlus USD |
430 |
GICC |
| VISA B+S ep2 (Datatrans) |
381 |
ep2:ACQSUB |
| VISA B+S ep2 (TKC) |
476 |
ep2:ACQSUB |
| VISA B+S GICC |
102 |
GICC |
| VISA B+S GICC GBP |
229 |
GICC |
| VISA B+S GICC USD |
225 |
GICC |
| VISA B+S POS |
484 |
|
| VISA B+S SET |
162 |
SET/NETLIFE |
| VISA B+S TRT3 CHF |
275 |
GICC |
| VISA Citicorp |
69 |
GICC |
| VISA Citicorp CHF |
191 |
GICC |
| VISA Citicorp CHF |
263 |
GICC |
| VISA Citicorp DKK |
265 |
GICC |
| VISA Citicorp DKK |
211 |
GICC |
| VISA Citicorp EUR |
175 |
GICC |
| VISA Citicorp GBP |
269 |
GICC |
| VISA Citicorp GBP |
185 |
GICC |
| VISA Citicorp SEK |
213 |
GICC |
| VISA Citicorp SEK |
267 |
GICC |
| VISA Citicorp SET |
165 |
SET/NETLIFE |
| VISA Citicorp USD |
183 |
GICC |
| VISA Citicorp USD |
221 |
GICC |
| VISA ConCardis |
118 |
GICC |
| VISA ConCardis CHF |
122 |
GICC |
| VISA ConCardis CHF |
126 |
GICC |
| VISA Concardis ep2 |
461 |
ep2:ACQSUB |
| VISA ConCardis SET |
152 |
SET/NETLIFE |
| VISA ConCardis USD |
150 |
GICC |
| VISA Corner CAR CHF |
4 |
CARCDS |
| VISA Corner CAR EUR |
65 |
CARCDS |
| VISA Corner CAR USD |
55 |
CARCDS |
| VISA Multipay CAR |
339 |
CARCDS |
| VISA Multipay ep2 |
363 |
ep2:ACQSUB |
| VISA Multipay NSP |
337 |
CARCDS |
| VISA Multipay POS |
231 |
|
| VISA Multipay POS Smash |
233 |
|
| VISA Multipay SET |
94 |
SET/NETLIFE |
| VISA OmniPay Postbank |
359 |
GICC |
| VISA Streamline ep2 |
425 |
ep2:ACQSUB |
| VISA UCC CAR CHF |
3 |
CARCDS |
| VISA UCC CAR EUR |
51 |
CARCDS |
| VISA UCC CAR GBP |
310 |
CARCDS |
| VISA UCC CAR USD |
13 |
CARCDS |
| VISA UCC DEM |
137 |
CARCDS |
| VISA UCC Purchasing |
63 |
CARCDS | | 
