3.40. /api/3ds/v1/upload-cres-result

After receiving cRes value to notificationURL, upload the results using HTTP POST request to URLs and the parameters specified below.

API URLs

Integration

Production

https://sandbox.payneteasy.eu/paynet/api/3ds/v1/upload-cres-result/ENDPOINTID

https://gate.payneteasy.eu/paynet/api/3ds/v1/upload-cres-result/ENDPOINTID

https://sandbox.payneteasy.eu/paynet/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID

https://gate.payneteasy.eu/paynet/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID

Request Parameters

Parameter Name

Max Length

Description

cRes

4096

The CRes message is the ACS response to the CReq message. It indicates the result of the Cardholder authentication.

orderid

128

Order id assigned to the order by Payneteasy.

login

20

Merchant login name.

client-order-id

128

Merchant order identifier.

control

40

Checksum generated by SHA-1. Control string is represented as concatenation of the following parameters:
1. login
2. client_orderid
3. orderid
4. merchant_control (Control key assigned to Merchant account in the Payneteasy gateway system)

Response Parameters

Parameter Name

Description

type

The type of response. May be async-response, validation-error, error. If type equals validation-error or error, error-message and error-code parameters contain error details.

paynet-order-id

Order id assigned to the order by Payneteasy.

merchant-order-id

Merchant order id.

serial-number

Unique number assigned by Payneteasy server to particular request from the Merchant.

error-message

If status is error this parameter contains the reason for decline or error details.

error-code

The error code is case of error status.

Request Example

POST /paynet/api/3ds/v1/upload-cres-result/39529 HTTP/1.1
User-Agent: curl/7.83.0
Accept: */*
Content-Length: 495
Content-Type: application/x-www-form-urlencoded
Connection: close

cres=ewogICJtZXNzYWdlVHlwZSIgICAgOiAiQ1JlcyIsCiAgIm1lc3NhZ2VWZXJzaW9uIiA6ICIyLjEuMCIsCgogICJ0aHJlZURTU2VydmVyVHJhbnNJRCIgOiAiZDAwYTdhZmUtMmE0ZC00NmI0LThmN2YtZjRlZmFkZjE0MmIzIiwKICAiYWNzVHJhbnNJRCIgICAgICAgICAgIDogImFjYWMwMzAxLTVlMWItNDk3Yy04NzA0LTZkNTU5NTc1YTRmZSIsCgogICJjaGFsbGVuZ2VDb21wbGV0aW9uSW5kIiA6ICJZIiwKICAidHJhbnNTdGF0dXMiICAgICAgICAgICAgOiAiWSIKfQ==
&orderid=6684126
&control=d0539beedb9a7266547530c8d2027f2b14503a61
&login=test1
&client-order-id=1e21f041-871d-4642-a6d9-968457df47a0

Success Response Example

HTTP/1.1 200
Server: server
Date: Wed, 17 Nov 2021 11:03:17 GMT
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Keep-Alive: timeout=60
Vary: Accept-Encoding
X-XSS-Protection: 1
Strict-Transport-Security: max-age=31536000
Content-Language: ru-RU
P3P: CP="NOI ADM DEV COM NAV OUR STP"
Content-Encoding: gzip

type=async-response
&serial-number=00000000-0000-0000-0000-000002d6202d
&merchant-order-id=1e21f041-871d-4642-a6d9-968457df47a0
&paynet-order-id=6684126

Fail Response Example

HTTP/1.1 200
Server: server
Date: Wed, 17 Nov 2021 11:03:17 GMT
Content-Type: text/html;charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
Keep-Alive: timeout=60
Vary: Accept-Encoding
X-XSS-Protection: 1
Strict-Transport-Security: max-age=31536000
Content-Language: ru-RU
P3P: CP="NOI ADM DEV COM NAV OUR STP"
Content-Encoding: gzip

type=validation-error
&serial-number=00000000-0000-0000-0000-000002b36f64
&merchant-order-id=inv4097763
&error-message=End+point+with+id+22903+not+found
&error-code=3

Postman Collection

Request Builder

URL
cres

Input CRes message

login

input Login

client_orderid

input Invoice Number

orderid

input sandbox.payneteasy.eu Transaction Number

merchant_control

input Control Key

String to sign
Signature