Payment receipts

Financial Line provides the ability to generate receipts in the form of a PDF file or raw HTML for successful payments/operations. Such receipts may be generated in PDF and raw HTML formats for the following operations: purchase (regular and split payments), auth, credit, and refund.

The receipts for the incoming transactions (purchase, auth) include such data as:

• Receipt/transaction number
• Payer's full name
• Card mask and its brand
• Payer's taxpayer identification number
• Payer's identifier in your system
• Your business name
• Your business identification code
• Your business IBAN
• Order amount
• External fee
• Total amount
• Transaction date and time
• Value date
• Payment purpose
• Your business website
• Identifier in the acquiring bank
• Authorization code
• Type of operation
• Acquirer identifier
• Payment device identifier
• Information about the financial company through which the payment was processed

The receipts (payment instruction) for outgoing transactions (credit) may contain the following information:

• Payment instruction/transaction number
• Your business name
• Your business identification code
• Your business IBAN
• Your business website
• Recipient's full name
• Recipient's card mask and its brand
• Recipient's taxpayer identification number
• Recipient's identifier in your system
• Amount
• Date and time of acceptance for execution
• Date and time of the transaction
• Order number
• Identifier in the acquiring bank
• Authorization code
• Type of operation
• Acquirer identifier
• Payment device identifier
• Information about the financial company through which the transaction was processed

The receipts (refund notification) for refund transactions may contain the following information:

• Refund notification/transaction number
• Your business name
• Your business identification code
• Your business IBAN
• Your business website
• Recipient's full name
• Recipient's card mask and its brand
• Recipient's taxpayer identification number
• Recipient's identifier in your system
• Refund amount
• Date and time of the transaction
• Identifier in the acquiring bank
• Authorization code
• Type of operation
• Acquirer identifier
• Payment device identifier
• Information about the financial company through which the transaction was processed

info

The list of fields contained in receipts depends on the amount of information transmitted in each individual payment request.

You can obtain receipts using one of the following methods:

• Automatic delivery of receipts to your email for payments made within a specific project (for purchase transactions only).
• Retrieving receipts through an API request.
• Manual download of receipts via the merchant portal.

Automatic receipt delivery

The automatic receipt delivery option allows for emails with receipts in PDF format to be sent to the specified email address for every successful transaction of the above-mentioned types. To configure this receipt delivery method, please contact Financial Line Support.

API-Based receipt downloads

We offer the option to request receipts through our API. This method enables receiving receipts in either HTML or PDF formats.

To receive a receipt for a particular payment, the GET HTTP method request must be made, including the following set of parameters:

Path variables:

Parameter	Type	Required	Description
POS_ID	UUID	✅	Merchant's identifier (POS_ID)
ORDER_ID	String	✅	Merchant's order identifier

Query parameters:

Parameter	Type	Required	Description
TRANSACTION_ID	UUID		Mandatory for credit transactions. If not provided, the receipt for the incoming transaction within the order will be received
FORMAT	String	✅	Receipt format (html, pdf)

Request example:

$ curl -i "http://api.finline.io/api/v1/pos/${POS_ID}/orders/${ORDER_ID}/report/receipt?transactionId=TRANSACTION_ID&format=pdf" \
-H "Content-Type: application/json" \
-H "X-API-AUTH: CPAY ${API_KEY}:${API_SECRET}" \
-H "X-API-KEY: ${ENDPOINTS_KEY}"

The response to the request will be provided in raw HTML format.

If needed, you can also retrieve receipts for all successful transactions of a specific type made on a specific date. To do so, you must include the following set of parameters in your request:

Parameter	Type	Required	Description
POS_ID	String	✅	Merchant's identifier (POS_ID)
DATE	String	✅	Date in yyyy-MM-dd format
FORMAT	String	✅	Receipt format (html, pdf)
METHOD	ENUM		Payment method (purchase, auth, credit). If not provided, receipts for purchase and auth transactions will be sent

Request example:

$ curl -i "https://api.finline.io/api/v1/pos/${POS_ID}/date/${DATE}/re port/receipt?format=${FORMAT}" \
-H "X-API-AUTH: CPAY ${API_KEY}:${API_SECRET}" \
-H "X-API-KEY: ${ENDPOINTS_KEY}"

In response to such a request, a ZIP archive containing all receipts for transactions of the corresponding type conducted on the date specified in the request will be sent to you.

caution

Receipts for a specific date cannot be obtained for purchase transactions involving split payments.

Downloading receipts through the merchant portal

The way to download receipts via the merchant portal:

1. Proceed to the "Transactions" section, find the required transaction, click the button to initiate additional actions, and select the corresponding option from the list.

2. In the "Transactions" section, find the required transaction and view its details by clicking on the corresponding record. In the details of the transaction, select the corresponding option from the list of additional actions located in the upper right corner of the page.

Once you have followed one of these ways, the receipt file will be automatically downloaded to your computer or mobile device.