Receipt

Structured receipt details for a transaction. The transaction's amount, vat_amount, and tip_amount, as well as event amounts, are returned as decimal strings in major currency units, for example "10.10" for EUR 10.10.

Fields

  • Transaction details displayed on a receipt.

    Example: {"transaction_code":"TEENSK4W2K","transaction_id":"410fc44a-5956-44e1-b5cc-19c6f8d727a4","merchant_code":"MH4H92C7","amount":"10.10","vat_amount":"6.00","tip_amount":"3.00","currency":"EUR","timestamp":"2020-02-29T10:56:56.876Z","status":"SUCCESSFUL","payment_type":"ECOM","entry_mode":"CUSTOMER_ENTRY","installments_count":1,"process_as":"CREDIT"}

    Show 20 properties
    • Transaction code returned after processing the transaction.

      Example: "TEENSK4W2K"

    • Unique identifier of the transaction.

      Example: "410fc44a-5956-44e1-b5cc-19c6f8d727a4"

    • Short unique identifier for the merchant.

      Example: "MH4H92C7"

    • amountstring

      Total transaction amount, in major units.

      Example: "10.10"

    • VAT included in the transaction amount, in major units.

      Example: "6.00"

    • Tip included in the transaction amount, in major units.

      Example: "3.00"

    • currencystring

      Three-letter ISO 4217 currency code of the transaction.

      Example: "EUR"

    • timestampstring
      format: date-time

      The timestamp of when the transaction was created.

      Example: "2020-02-29T10:56:56.876Z"

    • statusstring

      Current processing status of the transaction.

      Example: "SUCCESSFUL"

    • Payment type used for the transaction.

      Example: "ECOM"

    • Entry mode of the payment details.

      Example: "CUSTOMER_ENTRY"

    • Cardholder verification method.

      Example: "none"

    • Card reader details displayed on the receipt.

      Show 2 properties
      • codestring

        Unique identifier of the physical card reader.

        Example: "U1DT3NA00-CN"

      • typestring

        Model of the physical card reader.

        Example: "solo"

    • cardobject

      Payment card details displayed on the receipt.

      Show 2 properties
      • Last four digits of the payment card number.

        Example: "3456"

      • typestring

        Issuing card network of the payment card.

        Example: "VISA"

    • Number of installments.

      Example: 1

    • Options:"CREDIT""DEBIT"

      Whether the transaction was processed as credit or debit.

      Example: "CREDIT"

    • productsarray<object>

      Products associated with the transaction.

      Show 10 properties
      • namestring

        Product name.

        Example: "Coffee"

      • Product description.

        Example: "Cappuccino"

      • pricestring
        format: double

        Product price.

        Example: "150.0"

      • vat_ratestring
        format: double

        VAT rate.

        Example: "0.0"

      • format: double

        VAT amount for a single product.

        Example: "0.0"

      • format: double

        Product price including VAT.

        Example: "150.0"

      • format: double

        Total VAT amount for the product quantity.

        Example: "0.0"

      • quantityinteger
        format: int64

        Product quantity.

        Example: 1

      • format: double

        Total price calculated as the product price multiplied by the quantity.

        Example: "150.0"

      • format: double

        Total product price including VAT.

        Example: "150.0"

    • vat_ratesarray<object>

      VAT breakdown for the transaction.

      Show 4 properties
      • grossnumber
        format: float

        Gross amount to which the VAT rate applies.

        Example: 10.1

      • netnumber
        format: float

        Net amount to which the VAT rate applies.

        Example: 8.49

      • ratenumber
        format: float

        VAT rate applied to the transaction amount.

        Example: 0.19

      • vatnumber
        format: float

        VAT amount included in the gross amount.

        Example: 1.61

    • eventsarray<object>

      Transaction events displayed on the receipt.

      Show 7 properties
      • idinteger
        format: int64

        Numeric identifier of a transaction event. Use it as tx_event_id when requesting receipt details for a specific event. This is separate from the transaction ID and the transaction history pagination references.

        Example: 9567461191

      • Unique identifier of the transaction.

        Example: "410fc44a-5956-44e1-b5cc-19c6f8d727a4"

      • typestring
        Options:"PAYOUT""CHARGE_BACK""REFUND""PAYOUT_DEDUCTION"

        Financial event associated with a transaction.

        • PAYOUT: Funds from the transaction being prepared for or included in a merchant payout. Check the event status to determine whether they have been paid out.
        • REFUND: Money returned to the payer.
        • CHARGE_BACK: A reversal of the payment following a chargeback.
        • PAYOUT_DEDUCTION: An amount deducted from a merchant payout, for example to cover a refund or chargeback.

        Example: "REFUND"

      • statusstring
        Options:"FAILED""PAID_OUT""PENDING""RECONCILED""REFUNDED""SCHEDULED""SUCCESSFUL"

        Status of the transaction event.

        Not every value is used for every event type.

        • PENDING: The event has been created but is not final yet. Used for events that are still being processed and whose final outcome is not known yet.
        • SCHEDULED: The event is planned for a future payout cycle but has not been executed yet. This applies to payout events before money is actually sent out.
        • RECONCILED: The underlying payment has been matched with settlement data and is ready to continue through payout processing, but the funds have not been paid out yet. This applies to payout events.
        • PAID_OUT: The payout event has been completed and the funds were included in a merchant payout.
        • REFUNDED: A refund event has been accepted and recorded in the refund flow. This is the status returned for refund events once the transaction amount is being or has been returned to the payer.
        • SUCCESSFUL: The event completed successfully. Use this as the generic terminal success status for event types that do not expose a more specific business outcome such as PAID_OUT or REFUNDED.
        • FAILED: The event could not be completed. Typical examples are a payout that could not be executed or an event that was rejected during processing.

        Example: "SUCCESSFUL"

      • amountstring
        format: double

        Amount associated with the transaction event, in major units.

        Example: "10.10"

      • timestampstring
        format: date-time

        The timestamp of when the transaction event occurred.

        Example: "2020-05-25T10:49:42.784Z"

      • Receipt number associated with the event.

        Example: "123456"

    • Receipt number associated with the transaction.

      Example: "123456"

  • Merchant details displayed on a transaction receipt.

    Show 2 properties
    • Merchant profile details displayed on the receipt.

      Show 8 properties
      • Short unique identifier for the merchant.

        Example: "MH4H92C7"

      • Business name of the merchant.

        Example: "Coffee House"

      • Company registration number of the merchant.

        Example: "HRB 123456"

      • vat_idstring

        VAT identification number of the merchant.

        Example: "DE123456789"

      • websitestring

        Website of the merchant.

        Example: "https://example.com"

      • emailstring

        Email address of the merchant.

        Example: "merchant@example.com"

      • languagestring

        Language configured for the merchant profile.

        Example: "de"

      • addressobject

        Business address of the merchant.

        Show 9 properties
        • First line of the merchant address.

          Example: "Sample street 1"

        • Second line of the merchant address.

          Example: "Floor 2"

        • citystring

          City of the merchant address.

          Example: "Berlin"

        • countrystring

          Two-letter ISO 3166-1 alpha-2 country code of the merchant address.

          Example: "DE"

        • English name of the country in the merchant address.

          Example: "Germany"

        • Localized name of the country in the merchant address.

          Example: "Deutschland"

        • Region or state of the merchant address.

          Example: "Berlin"

        • post_codestring

          Postal code of the merchant address.

          Example: "10115"

        • landlinestring

          Landline phone number of the merchant.

          Example: "+493012345678"

    • localestring

      Locale used for rendering localized receipt fields.

      Example: "de-DE"

  • emv_dataobject

    EMV-specific metadata returned for card-present payments.

    Example: {}

  • Acquirer-specific metadata related to the card authorization.

    Example: {"authorization_code":"053201","return_code":"00"}

    Show 4 properties
    • tidstring

      Identifier of the terminal used for the authorization.

      Example: "12345678"

    • Authorization code returned by the acquirer.

      Example: "053201"

    • Return code reported by the acquirer.

      Example: "00"

    • Local timestamp of the card authorization.

      Example: "2020-02-29T11:56:56+01:00"

Type to search…