Barzahlen / viacash for WooCommerce — cash payment at the store till

Barzahlen / viacash for WooCommerce adds cash payment at the till to WooCommerce: the buyer places the order, gets a payment slip with a barcode from viacash and pays it at the till of a partner store, for example a supermarket or a drugstore. When viafintech reports the slip paid, the order moves to Processing. The module works with your own viafintech account (division ID and API key), on the classic and the block checkout, with HPOS; the interface is English and German for the DE, AT and CH markets.

What the free version does

The settings live in one place: WooCommerce → Barzahlen. Enter the division ID and the API key from the viafintech App, choose the viafintech sandbox or live mode and press “Check connection”: a signed call to viafintech shows whether the key is accepted. The API key is stored encrypted and is never printed back into the form. Every order gets one slip: the order total, the order number as reference and an expiry from 1 to 30 days (7 by default). Placing the same order again gives the same slip, a request that timed out is repeated with the same idempotency key, so there are never two slips; if the total changes, the old slip is invalidated and a new one is made. After checkout the order waits for the payment (On hold), and the thank-you page and “My account → Orders” open the viacash overlay: the slip as a PDF, the nearest stores, the slip sent to a phone; a button opens it again. When the billing address is complete, the buyer sees the three nearest partner stores. The viafintech webhook is checked with its BZ1-HMAC-SHA256 signature: a paid slip moves the order to Processing, and a paid amount that differs from the order total puts it on hold with an explanation; an expired or invalidated slip cancels the order and puts the stock back; a declined slip sets Failed; repeated webhooks change nothing. The webhook address goes out with every slip (on an https site), otherwise you enter it in the viafintech App. The “Check the status with viafintech” button on the order asks viafintech about the slip if the webhook did not arrive. The buyer identifier for viafintech is the e-mail address or the shop customer number. Currencies: EUR, CHF, BGN, CZK, HUF, PLN, RON, SEK, GBP, as your contract allows.

What Pro adds

Refunds from WooCommerce as a refund slip, full or partial; the refunds can never exceed what was paid, and viafintech reports when the buyer has collected the money at a till. Reminders: a set number of hours before the slip expires, viacash sends it to the buyer again. Cancelling the order in WooCommerce invalidates the open slip. An hourly check of open slips not heard of for 6 hours (for a missed webhook) and a “Re-check all open slips now” button. A journal of the last 200 webhooks with the outcome of each. The slip by text message to the billing phone (the international format is made from the billing country); on the order, buttons to send the slip again by e-mail or SMS, to invalidate it and to create a new slip. Rules for who sees the method: the order total from and to, billing countries, customer groups (guests included); it works on the classic and the block checkout. A German translation of the interface, a licence with a 7-day trial and updates from the admin.

Good to know before you start

• You need your own viafintech account: the division ID and the API key are in the viafintech App (Settings / Divisions). The sandbox is available right after sign-up; live payments need a contract with viafintech. The module does not do the sign-up.
• The “paid” webhook arrives after the store’s cooldown period, so some minutes after the buyer paid at the till; until then the order stays On hold.
• A site without https: viafintech does not call http addresses, so the status is updated by the “Check the status” button (Free) or by the hourly check (Pro); the settings screen shows a red warning.
• Which buyer identifier your contract expects, the e-mail address or a customer number, is set in the settings; a wrong choice gives errors from the API.
• viafintech’s limits on the amount and the number of slips per buyer apply on their side: when an order exceeds them, the buyer sees “cash payment at a store is not possible, please choose another method” and the order carries a note with the reason.
• The viacash overlay script is loaded from cdn.viafintech.com, as viafintech requires.
• The module is independent, not an official viafintech plugin and not affiliated with viafintech.

How it works, step by step

1. In the viafintech App take the division ID and the API key (Settings / Divisions).
2. In WooCommerce → Barzahlen enter them, keep the sandbox on and press “Check connection”, then save.
3. Turn on “Barzahlen / viacash” in WooCommerce → Settings → Payments; on an https site the webhook address goes out with every slip.
4. The buyer places the order, gets the slip and pays it at the till; the order moves to Processing by the webhook.

Under the hood

• Calls to API v2 are signed with the API key (HMAC-SHA256); the key itself is never sent.
• A slip is created with an Idempotency-Key header, so a repeat after a timeout gives the same slip.
• The webhook is checked by its signature and the Date header; a slip of another shop is ignored and repeats add no duplicate notes.
• The API key is stored encrypted; compatible with HPOS and the block checkout; languages: English, Deutsch (de_DE, de_AT, de_CH).

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
2. WooCommerce → Barzahlen: division ID, API key, “Check connection”.
3. If needed, enter the webhook address from the settings screen in the viafintech App (Notification URL).
4. Turn on the “Barzahlen / viacash” payment method.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.