Sign in

v1

latestOpenAPI 3.0.22026-08-061303782.1 MB
Receipts

Create a Receipt

Create a Receipt resource to generate a receipt for a Transfer or Authorization. Receipts are supported for DEBIT and REVERSAL transfers, as well as CREDIT transfers from unreferenced refunds.

Include basic details such as total amount, buyer billing information, merchant name, and contact info.

Optionally, provide:

  • an amount_breakdown of charges like subtotal, shipping, and surcharges
  • an items list with product name, description, price, and quantity
  • include additional_details as an array of key-value pairs to capture extra metadata, such as "Invoice Number" or "Service Date".
post/receipts

Headers

Finix-Versionstring
Example:2022-02-01

Specify the API version of your request. For more details, see Versioning.

Content-Typestring
Example:application/json

The data type being sent in the request body must be application/json.

Request body

entity_idstring required

The ID of the Transfer or Authorization for which the receipt must be generated.

send_receipt_to_buyerboolean required

Whether to send a receipt to the buyer.

Response

A single Receipt

idstring

The ID of the resource.

created_atstring date-time

Timestamp of when the object was created.

updated_atstring date-time

Timestamp of when the object was last updated.

amountinteger

The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).

application_idstring

ID of the Application the resource was created under.

currency'CAD' | 'USD'

ISO 4217 3-letter currency code.

send_receipt_to_buyerboolean

Whether to send a receipt to the buyer.

device_idstring nullable

Applies to in-person payments. The ID of the Point-of-Sale terminal used to process the payment.

type'BUYER' | 'MERCHANT'

The type of receipt, either for the customer (BUYER) or the merchant (MERCHANT) for a CP (card-present) transaction. For a CNP transaction, the type will be BUYER.

receipt_urlstring

The location of the receipt on Finix's Amazon S3.

Example response

{
  "amount": 5000
}