3.8. /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.connpay.com/paynet/api/v2/get-card-info/ENDPOINTID

https://gate.connpay.com/paynet/api/v2/get-card-info/ENDPOINTID

https://sandbox.connpay.com/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID

https://gate.connpay.com/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID

Request Parameters

Note

Request must have content-type=application/x-www-form-urlencoded.

Parameter Name

Description

Value

login

Connecting Party’s login name.

Necessity: Mandatory
Type: String
Length: 20

cardrefid

Card reference ID obtained at Card Registration Stage.

Necessity: Mandatory
Type: String
Length: 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 ConnPay gateway system).
Necessity: Mandatory
Type: String
Length: 128

Response Parameters

Note

Response has Content-Type: text/html;charset=utf-8 header. All fields are x-www-form-urlencoded, with (0xA) character at the end of each parameter’s value.

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 ConnPay 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.connpay.com
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

endpointid or groupid

input ENDPOINTID or ENDPOINTGROUPID

login
card-ref-id
merchant_control

input Control Key

String to sign
Signature