- Created by PAYONE Admin, last modified by PAYONE Writer on 2021-01-06
Checks the card for participation in the 3-D Secure procedure and initiates a 3-D Secure session if required.
Additionally, this request offers the possibility to store credit card data. In this case, the response submits what is known as a pseudo card number.
Request "3dscheck" | ||||||||||||||||||||||||||||||||||||
Common Parameter | Required | Format | Comment | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+ | Format | |||||||||||||||||||||||||||||||||||
+ | Specifies the total gross amount of a payment transaction. Value is given in smallest currency unit, e.g. Cent of Euro; Pence of Pound sterling; Öre of Swedish krona. The amount must be less than or equal to the amount of the corresponding booking. Format NUMERIC(1..10) Permitted values max. +/- 19 999 999 99 | |||||||||||||||||||||||||||||||||||
+ | Specifies currency for this transaction Format LIST Permitted values ISO 4217 (currencies) 3-letter-codes Samples EUR USD GBP | |||||||||||||||||||||||||||||||||||
+ | Format LIST
| |||||||||||||||||||||||||||||||||||
+ | Exit-URL to be forwarded after authentication on the ACS Format | |||||||||||||||||||||||||||||||||||
o | Primary account number of credit card Format | |||||||||||||||||||||||||||||||||||
o | Pseudo primary account number for a credit card. Format | |||||||||||||||||||||||||||||||||||
+ | Card type of credit card Format V Visa 4 M MasterCard A American Express 300-305,3095,36,38,39 601, 64, 65 J JCB O Maestro International *girocard is currently only viable for e-commerce-payments via Apple Pay. | |||||||||||||||||||||||||||||||||||
+ | Credit card expiry date YYMM Format NUMERIC(4), YYMM | |||||||||||||||||||||||||||||||||||
o | Format For SAQ A compliance: PAYONE Frontend hosted iFrame must be used. This parameter must not be used. | |||||||||||||||||||||||||||||||||||
- | Format Card data is not stored Card data is stored, a pseudo card number is returned | |||||||||||||||||||||||||||||||||||
- | Language indicator (ISO 639) to specify the language that should be presented to the customer (e.g. for error messages, frontend display). If the language is not transferred, the browser language will be used. For a non-supported language English will be used. Format LIST Permitted values ISO 639-1 (Language) 2-letter-codes |
Response "3dscheck" | |||
Common Parameter | Required | Format | Comment |
---|---|---|---|
status | + | Default | VALID card number valid INVALID card number invalid ENROLLED card participates ERROR request faulty |
Parameter (VALID) | |||
+ | 3-D Secure transaction ID (if the request "3dscheck" was used previous transactions), i.e.: Format | ||
o | Pseudo primary account number for a credit card. Format | ||
o | Masked cardpan, i.e. 411111xxxxxx1111 (is returned if storecarddata=yes) Format CHAR(13..19) | ||
Parameter (ENROLLED) | |||
acsurl | + | AN..255 | ACS URL -> redirect customer to this URL. Here the customer will have to complete 3-D authorization at his bank. -> add response-values for “termurl”, “pareq” and “md” as post data while redirecting |
termurl | + | AN.255 | URL of the PAYONE Platform validation page -> add this response-value with key “TermUrl” to post data while redirecting to returned acsurl |
pareq | + | AN..1000 | Request message to ACS -> add this response-value with key “PaReq” to post data while redirecting to returned acsurl |
md | + | N..12 | "Merchant Data" includes the PAYONE Platform reference ID -> add this response-value with key “MD” to post data while redirecting to returned acsurl |
xid | + | 3-D Secure transaction ID (if the request "3dscheck" was used previous transactions), i.e.: Format | |
o | Pseudo primary account number for a credit card. Format | ||
o | Masked cardpan, i.e. 411111xxxxxx1111 (is returned if storecarddata=yes) Format CHAR(13..19) | ||
Parameter (INVALID) | |||
+ | In case of error the PAYONE Platform returns an error code for your internal usage. Format | ||
+ | In case of error the PAYONE Platform returns an error message for your internal usage. Format | ||
- | The customermessage is returned to your system in order to be displayed to the customer. (Language selection is based on the end customer's language, parameter "language") Format | ||
Parameter (ERROR) | |||
+ | In case of error the PAYONE Platform returns an error code for your internal usage. Format | ||
+ | In case of error the PAYONE Platform returns an error message for your internal usage. Format | ||
- | The customermessage is returned to your system in order to be displayed to the customer. (Language selection is based on the end customer's language, parameter "language") Format |
- No labels