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.goldenapple.com.cy/paynet/api/v2/get-card-info/ENDPOINTID	https://gate.goldenapple.com.cy/paynet/api/v2/get-card-info/ENDPOINTID
https://sandbox.goldenapple.com.cy/paynet/api/v2/get-card-info/group/ENDPOINTGROUPID	https://gate.goldenapple.com.cy/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 GoldenApple 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 GoldenApple 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.goldenapple.com.cy
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