{"title":"Configure POS payment methods","slug":"pos-payment-methods","url":"https://support.storeconnect.com/articles/pos-payment-methods","url_markdown":"https://support.storeconnect.com/articles/pos-payment-methods.md","subtitle":null,"summary":"Enable, disable, relabel, and configure POS payment methods using Store Variables, covering all available payment types including integrated card readers, Latitude, Vii gift cards, and account-based payments.","type":"Help_Documentation","video_url":"","keywords":"POS payment methods, configure payments, cash, card, integrated card reader, Latitude, Vii gift card, pay on account, EFT, payment options, store variables, pos.payment_options, enable payment, disable payment, relabel payment, purchase order","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"POS payment methods are configured using Store Variables. All variables follow this pattern:\n\n```\npos.payment_options.{type}.{attribute}\n```\n\nWhere `{type}` is the payment method identifier (e.g. `cash`, `card_integrated`) and `{attribute}` is one of `enabled`, `label`, or `require_purchase_order`.\n\n## Payment methods at POS\n\nThe table below lists all available payment types, their default display labels, and whether they appear at POS by default.\n\n| Payment method | Type | Default label | Available by default |\n|---|---|---|---|\n| Cash | `cash` | Cash | Yes |\n| Card (manual) | `card` | Card (manual) | Yes |\n| Card (Tyro) | `card_integrated` | Card (Tyro) | Yes |\n| Card (Square) | `card_square_integrated` | Card (Square) | Yes |\n| Bank transfer | `bank` | Bank transfer | Yes |\n| Cheque | `cheque` | Cheque | Yes |\n| Voucher | `voucher` | Voucher | Yes |\n| Pay on account | `on_account` | Pay on account | Yes |\n| Account credit | `account_credit` | Account credit | Yes |\n| Pay by link | `pay_by_link` | Pay by link | Yes |\n| Latitude | `latitude` | Latitude | No — must be explicitly enabled |\n| Card (Linkly) | `linkly` | Card (Linkly) | No — must be explicitly enabled |\n| Card (Quest Airpay TAP) | `quest_airpay_tap` | Card (Quest Airpay TAP) | No — must be explicitly enabled |\n| Gift Card (Vii) | `vii` | Gift Card (Vii) | No — must be explicitly enabled |\n\n## Enable or disable a payment method\n\nPayment methods available by default appear at POS without any configuration. To remove one, set `enabled` to `False`. Payment methods not available by default are hidden until you set `enabled` to `True`.\n\n| Store variable key | Value |\n|---|---|\n| `pos.payment_options.{type}.enabled` | `True` or `False` |\n\n### Add a store variable to enable or disable a payment method\n\n1.  Open your store in StoreConnect.\n2.  In the **Key Relationships \u003e Store Variables** section, select **New**.\n\n    ![Cash payment method variable for POS ](https://res.cloudinary.com/hzkr6fi81/image/upload/v1773093931/knowledge/pos/disableTfrPayment_lyn1mf.png)\n\n3.  Enter a descriptive name for the variable, e.g. `Disable bank transfer at POS`.\n4.  Enter the key for the payment type, e.g. `pos.payment_options.bank.enabled`, and set the **Value** to `True` or `False`.\n5.  Select **Save**.\n6.  Repeat for any other payment methods you want to change.\n\n:::note\nLatitude and Vii also require a Payment Provider record with valid API credentials to be configured in Salesforce. The store variable alone is not sufficient to activate these integrations.\n:::\n\n## Require a purchase order number\n\nYou can require operators to enter a purchase order number when using a specific payment method. This is configured per payment type.\n\n| Store variable key | Value |\n|---|---|\n| `pos.payment_options.{type}.require_purchase_order` | `True` or `False` |\n\nFor example, to require a PO number when a customer pays on account:\n\n| Name | Key | Value |\n|---|---|---|\n| Require PO number for account payments | `pos.payment_options.on_account.require_purchase_order` | `True` |\n\nYou can apply this to any payment type — set it for each type separately.\n\n## Relabel payment methods at POS\n\nYou can change the display name of any payment method to match your store's terminology — for example, displaying \"EFTPOS\" instead of \"Card (Tyro)\", or \"Notes\" instead of \"Cash\".\n\n| Store variable key | Value |\n|---|---|\n| `pos.payment_options.{type}.label` | Your custom label text |\n\nThe table below shows the store variable key for each payment type.\n\n| Payment method | Default label | Store variable key |\n|---|---|---|\n| Cash | Cash | `pos.payment_options.cash.label` |\n| Card (manual) | Card (manual) | `pos.payment_options.card.label` |\n| Card (Tyro) | Card (Tyro) | `pos.payment_options.card_integrated.label` |\n| Card (Square) | Card (Square) | `pos.payment_options.card_square_integrated.label` |\n| Card (Quest Airpay TAP) | Card (Quest Airpay TAP) | `pos.payment_options.quest_airpay_tap.label` |\n| Card (Linkly) | Card (Linkly) | `pos.payment_options.linkly.label` |\n| Latitude | Latitude | `pos.payment_options.latitude.label` |\n| Bank transfer | Bank transfer | `pos.payment_options.bank.label` |\n| Cheque | Cheque | `pos.payment_options.cheque.label` |\n| Voucher | Voucher | `pos.payment_options.voucher.label` |\n| Pay on account | Pay on account | `pos.payment_options.on_account.label` |\n| Account credit | Account credit | `pos.payment_options.account_credit.label` |\n| Pay by link | Pay by link | `pos.payment_options.pay_by_link.label` |\n| Gift Card (Vii) | Gift Card (Vii) | `pos.payment_options.vii.label` |\n\n### Set a payment method label\n\n1.  Open your store in StoreConnect.\n2.  In the **Key Relationships \u003e Store Variables** section, select **New**.\n3.  Enter a descriptive name for the variable, e.g. `Relabel cash to Notes`.\n4.  Enter the key for the payment type (see table above) and your custom text as the **Value**.\n5.  Select **Save**.\n6.  Repeat for any other payment methods you want to relabel.\n\n:::note\nLabel changes take effect the next time POS is loaded or the page is refreshed. If a store variable exists but its value is empty, POS falls back to the default label.\n\nThe account credit label is also used in context-sensitive messages — for example, if you set it to \"Charge Account\", POS displays \"Refund to Charge Account\" and \"Charge Account applied\". Labels are configured at the store level and cannot be set per outlet or per register.\n:::"}