Payments

    Receipt Variables (Liquid Reference)

    Use POSBridge variables in the Shopify POS receipt code editor — with ready-to-use Liquid code examples.

    POSBridge automatically writes data to the Shopify order after every payment — tip amount, SumUp transaction ID, payment type and more. With a few lines of Liquid code, this information appears directly on the printed or digital receipt.

    Open the Receipt Code Editor

    1. Open Shopify POS on iPad or iPhone
    2. Tap the gear icon (Settings)
    3. Select Receipts
    4. Tap Code Editor
    5. Paste your Liquid code and tap Save

    Changes apply immediately — the next receipt will already show the new data.

    Available Variables (order.note_attributes)

    VariableContainsExample
    — Always set (every payment) —
    posbridge_payment_idUnique payment ID (useful for support requests)pay_a1b2c3d4
    posbridge_sumup_txSumUp transaction IDT8F2...XA91
    posbridge_charged_centsCharged amount in cents (excl. tip)1800
    posbridge_charged_modePayment mode: FULL or PARTIALFULL
    — Only when tip was selected —
    posbridge_tip_amountTip amount (formatted)2.00 €
    posbridge_tip_subtotalCart value without tip (formatted)18.00 €
    posbridge_tip_totalGrand total incl. tip (formatted)20.00 €

    💡 The currency format of the formatted amounts (e.g. whether € appears before or after the number) can be changed under Settings → POS Extension → Currency format on receipt.

    Warning

    Important: posbridge_charged_cents returns the amount as an integer in cents — not euros. Example: 1800 = €18.00. For a formatted euro amount on the receipt use posbridge_tip_subtotal instead (e.g. 18.00 €).

    Beispiel · So sieht der Kassenbon aus
    ────────────────────────────
            MEIN CAFÉ BERLIN
    ────────────────────────────
     Cappuccino           3,50 €
     Croissant            2,50 €
     Espresso             2,00 €
       ...
    
     Warenwert:          18,00 €
     Trinkgeld:           2,00 €
                        ────────
     GESAMT:             20,00 €
    
     Bezahlart: SumUp Terminal
     SumUp TX:  T8F2...XA91
     Ref:       pay_a1b2c3d4
    
     Vielen Dank für Ihren Besuch!
    ────────────────────────────

    Ready-to-Use Code Snippets

    Copy one of the blocks below into the code editor (Shopify POS → Settings → Receipts → Code Editor). Customise labels like Tip: or Total: as needed.

    Snippet 1 — Show tip amount only

    {% assign pb_tip = order.note_attributes | where: "name", "posbridge_tip_amount" | first %}
    {% if pb_tip %}
    Tip: {{ pb_tip.value }}
    {% endif %}

    Snippet 2 — Full breakdown (subtotal + tip + total)

    {% assign pb_tip = order.note_attributes | where: "name", "posbridge_tip_amount"   | first %}
    {% assign pb_sub = order.note_attributes | where: "name", "posbridge_tip_subtotal" | first %}
    {% assign pb_tot = order.note_attributes | where: "name", "posbridge_tip_total"    | first %}
    {% if pb_tip %}
    Subtotal: {{ pb_sub.value }}
    Tip:      {{ pb_tip.value }}
    --------------------
    Total:    {{ pb_tot.value }}
    {% endif %}

    Snippet 3 — Payment reference & payment type (always available)

    {%- assign pb_ref  = order.note_attributes | where: "name", "posbridge_payment_id"   | first -%}
    {%- assign pb_tx   = order.note_attributes | where: "name", "posbridge_sumup_tx"     | first -%}
    {%- assign pb_mode = order.note_attributes | where: "name", "posbridge_charged_mode" | first -%}
    
    {% if pb_ref  %}Payment ref.: {{ pb_ref.value }}{% endif %}
    {% if pb_tx   %}SumUp TX:     {{ pb_tx.value }}{% endif %}
    {% if pb_mode %}
      {% if pb_mode.value == "FULL"  %}Full payment{% endif %}
      {% if pb_mode.value == "PARTIAL" %}Partial payment{% endif %}
    {% endif %}
    Tip

    For tax questions about tips please consult your tax advisor — treatment varies by country and business type.