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

IntegrationProduction
https://sandbox.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTIDhttps://pay.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTID
https://sandbox.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTGROUPIDhttps://pay.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTGROUPID

Request Parameters

Parameter NameMax LengthDescription
cRes4096The CRes message is the ACS response to the CReq message. It indicates the result of the Cardholder authentication.
orderid128Order id assigned to the order by Billblend.
login20Merchant login name.
client-order-id128Merchant order identifier.
control40Checksum generated by SHA-1. Control string is represented as concatenation of the following parameters:1. login2. client_orderid3. orderid4. merchant_control (Control key assigned to Merchant account in the Billblend gateway system)

Response Parameters

Parameter NameDescription
typeThe type of response. May be async-responsevalidation-errorerror. If type equals validation-error or error, error-message and error-code parameters contain error details.
paynet-order-idOrder id assigned to the order by Billblend.
merchant-order-idMerchant order id.
serial-numberUnique number assigned by Billblend server to particular request from the Merchant.
error-messageIf status is error this parameter contains the reason for decline or error details.
error-codeThe 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

Postman Collection is available at this link – https://doc.billblend.com/integration/API_commands/upload-cres-result.html#postman-collection

Request Builder

Request Builder is available at this link – https://doc.billblend.com/integration/API_commands/upload-cres-result.html#request-builder

URL
cresInput CRes message
logininput Login
client_orderidinput Invoice Number
orderidinput sandbox.billblend.com Transaction Number
merchant_controlinput Control Key
curl --data "cRes=ewogICJh...AiTiIKfQ&login=logic&client_orderid=902B4FF5&orderid=159884&control=6ef9cae82e765a7f43d4b596f8186cf20962e349" https://sandbox.billblend.com/checkout/api/3ds/v1/upload-cres-result/ENDPOINTID

Contact us

By clicking on the button, you agree to the data protection policy

Complete the quiz

By clicking on the button, you agree to the data protection policy