3.35. /api/3ds/v1/upload-pares-result

Upload PaRes Result

After receiving paRes value to TermUrl, 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-pares-result/ENDPOINTIDhttps://pay.billblend.com/checkout/api/3ds/v1/upload-pares-result/ENDPOINTID
https://sandbox.billblend.com/checkout/api/3ds/v1/upload-pares-result/ENDPOINTGROUPIDhttps://pay.billblend.com/checkout/api/3ds/v1/upload-pares-result/ENDPOINTGROUPID

Request Parameters

Parameter NameMax LengthDescription
paRes10240Payer Authentication Response message is returned by the ACS with the result of cardholder payment 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-pares-result/39529 HTTP/1.1
User-Agent: curl/7.83.0
Accept: */*
Content-Length: 2631
Content-Type: application/x-www-form-urlencoded
Connection: close

orderid=6684127
&md=BB4A517A42736975764E3453302B303144794D754B7A4F697A7953765930784259503870546A79416F6542646F4E4A69534F3243317431726A6352702B68565271
&paRes=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
&control=987e7aa6630a862805c65eee02392d7a769cadbe
&login=test_merchant
&client-order-id=e690bf9f-0c90-4073-a30a-604d13ae9fb9

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-000002d62036
&merchant-order-id=e690bf9f-0c90-4073-a30a-604d13ae9fb9
&paynet-order-id=6684127

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-pares-result.html#postman-collection

Request Builder

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

URL
paresInput Payer Authentication Response message
logininput Login
client_orderidinput Invoice Number
orderidinput sandbox.billblend.com Transaction Number
merchant_controlinput Control Key
curl --data "paRes=eJydVlm...BYTvkjk%3D&login=logic&client_orderid=902B4FF5&orderid=159884&control=6ef9cae82e765a7f43d4b596f8186cf20962e349" https://sandbox.billblend.com/checkout/api/3ds/v1/upload-pares-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