3.31. /view-invoice

Introduction

To start Swift transaction use /api/v2/auth-cash/ and get receipt-id in order status response. Swift invoice in PDF is initiated through HTTPS GET request by using URLs specified below. Use HMAC-SHA1 for authentication. See Statuses.

API URLs

Integration	Production
https://sandbox.billblend.com/checkout/view-invoice/ENDPOINTID/RECEIPTID	https://pay.billblend.com/checkout/view-invoice/ENDPOINTID/RECEIPTID

Request Example

POST /paynet/view-invoice/6657/a5e8f278-8936-3286-aabb-c8960a5d04f4 HTTP/1.1
Host: sandbox.billblend.com
User-Agent: curl/7.83.0
Accept: */*
Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="test_merch",oauth_timestamp="1687518156",oauth_nonce="EozU8eCdyBO",oauth_signature_method="HMAC-SHA1",oauth_signature="bNQNq2CLuGoOrf5eji3ffj96bC0%3D"
Content-Length: 140
Content-Type: application/x-www-form-urlencoded
Connection: close

oauth_consumer_key=test_merch
&oauth_nonce=EozU8eCdyBO
&oauth_signature_method=HMAC-SHA1
&oauth_timestamp=1687518156
&oauth_version=1.0

Success Response Example

HTTP/1.1 200
Server: server
Date: Fri, 23 Jun 2023 11:03:05 GMT
Content-Type: application/pdf;charset=utf-8
Connection: close
X-XSS-Protection: 1
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
Content-Length: 34929

...
*PDF content*

Fail Response Example

HTTP/1.1 200
Server: server
Date: Fri, 23 Jun 2023 12:23:15 GMT
Content-Type: application/pdf;charset=utf-8
Connection: close
X-XSS-Protection: 1
Strict-Transport-Security: max-age=31536000
Strict-Transport-Security: max-age=31536000
Content-Length: 34929

...
<body>
    <p>Sorry, that page doesn't exist!</p>
</body>

Postman Collection

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

Request Builder

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

HTTP method
endpointId
receiptId
version
consumer key
consumer secret
timestamp
nonce
signature method

curl -H 'Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="merchantlogin",oauth_signature_method="HMAC-SHA1",oauth_signature="WOJj4%2BmwdeVllFDBGjio4MIBcvc%3D"' --data 'oauth_consumer_key=merchantlogin&oauth_signature_method=HMAC-SHA1&oauth_version=1.0' 'https://sandbox.billblend.com/checkout/view-invoice/123/affb50c0-1234-1234-1234-f865d3a56d70' --output test.pdf

curl -H 'Authorization: OAuth realm="",oauth_version="1.0",oauth_consumer_key="merchantlogin",oauth_signature_method="HMAC-SHA1",oauth_signature="WOJj4%2BmwdeVllFDBGjio4MIBcvc%3D"' --data 'oauth_consumer_key=merchantlogin&oauth_signature_method=HMAC-SHA1&oauth_version=1.0' 'https://sandbox.billblend.com/checkout/view-invoice/123/affb50c0-1234-1234-1234-f865d3a56d70' --output test.pdf