3.33. /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.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTID |
https://pay.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTID |
https://sandbox.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID |
https://pay.billblend.com/checkout/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 Billblend. |
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 Billblend 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 Billblend. |
merchant-order-id |
Merchant order id. |
serial-number |
Unique number assigned by Billblend 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 /checkout/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
| String to sign |
|---|
| Signature |
|---|
|