3.12. /api/v2/get-card-info
Introduction
For integration purposes use staging environment HTTPS POST request to the URLs and the parameters specified below. Use SHA-1 for authentication. See Statuses.
API URLs
Integration |
Production |
---|---|
https://sandbox.payneteasy.eu/paynet/api/v2/get-card-info/ENDPOINTID |
https://gate.payneteasy.eu/paynet/api/v2/get-card-info/ENDPOINTID |
https://sandbox.payneteasy.eu/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID |
https://gate.payneteasy.eu/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID |
Request Parameters
Note
Parameter Name |
Description |
Value |
---|---|---|
login |
Connecting Party’s login name. |
Necessity : MandatoryType : StringLength : 20 |
cardrefid |
Card reference ID obtained at Card Registration Stage. |
Necessity : MandatoryType : StringLength : 20 |
control |
Checksum generated by SHA-1. Control string is represented as concatenation of the following parameters:
1. Request parameter: login
2. Request parameter: cardrefid
3. merchant_control (Control key assigned to Connecting Party account in the Payneteasy gateway system).
|
Necessity : MandatoryType : StringLength : 128 |
Response Parameters
Note
Information Response Parameters |
Description |
---|---|
type |
The type of response. May be get-card-info-response, validation-error, error.
If type equals error, error-message and error-code parameters contain error details.
|
serial-number |
Unique number assigned by Payneteasy server to particular request from the Connecting Party. |
card-printed-name |
Card holder’s name. |
bin |
Bank Identification Number. |
last-four-digits |
The last four digits of PAN. |
expire-year |
Card expiration year. |
expire-month |
Card expiration month. |
result-3d |
3DS completion result. |
error-message |
If status is validation-error or error this parameter contains the reason for decline or error details. |
error-code |
The error code is case of validation-error or error status. |
Request Example
POST /paynet/api/v2/get-card-info/46750 HTTP/1.1
Host: https://sandbox.payneteasy.eu
User-Agent: curl/7.85.0
Accept: */
Content-Length: 77
Content-Type: application/x-www-form-urlencoded
Connection: close
&login=Test
&cardrefid=1461665
&control=f8ffd7dac9e334799862da0e9190387510d43ff7
Success Response Example
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 11:21:39 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 193
type=get-card-info-response
&serial-number=00000000-0000-0000-0000-000002e0d218
&card-printed-name=CARD+HOLDER
&bin=453897
&last-four-digits=6732
&expire-year=2099
&expire-month=12
&result-3d=F
Fail Response Example
HTTP/1.1 200
Server: server
Date: Thu, 02 Feb 2023 11:26:22 GMT
Content-Type: text/html;charset=utf-8
Connection: close
Vary: Accept-Encoding
X-XSS-Protection: 1
X-Content-Type-Options: nosniff
Strict-Transport-Security: max-age=31536000
Content-Language: en-US
Strict-Transport-Security: max-age=31536000
Content-Length: 136
type=validation-error
&serial-number=00000000-0000-0000-0000-000002e0d21f
&error-message=End+point+with+id+99999+not+found
&error-code=3
Postman Collection
Request Builder
String to sign |
---|
Signature |
---|
|