At a glance
The aggregate gross authorised + captured value moving across Viva Payments rails in the period: online Smart Checkout, Smart POS card-present, Recurring Payments rebills, Marketplace Splits gross, and pay-by-link. The “how much money touched the rail” view, before refunds, fees, FX, or settlement timing.
| What it counts | SUM(transactions.Amount) where StatusId = F (Successful) on /api/transactions, summed in each transaction’s native CurrencyCode. Includes online checkout, Smart POS captures, recurring rebills, marketplace gross-before-split, and pay-by-link. Aliases the merchant-facing “Total Revenue” view but framed as a volume-of-rail metric (the same arithmetic, different lens for ops + treasury teams reconciling against Viva’s settlement file). |
| API endpoint | GET /api/transactions on the Smart Checkout API; OAuth2 client-credentials at accounts.vivapayments.com/connect/token. The /payments endpoint provides authoritative state where transactions are mid-lifecycle (auth-only, capture-pending). |
| Currency | Multi-currency native, no FX. Viva natively settles in 13+ currencies (EUR, GBP, RON, CHF, USD, BGN, HRK, HUF, PLN, CZK, DKK, NOK, SEK). This card sums each currency separately. Pan-EU merchants will see EUR + GBP + RON listed alongside each other. Use viva_revenue_by_country for an FX-rolled view. |
| Fees / processing cost | Gross. Viva interchange + scheme + acquiring fees (typically 0.8 to 1.4% blended for EU intra-EEA cards, higher for AmEx and non-EEA cards) are NOT deducted. Net-of-fees lives in the Settlements view, not here. |
| Refunds | NOT deducted. A fully refunded EUR 100 transaction still contributes EUR 100 here. Refunds are tracked in viv_refund_volume and viva_refund_value. |
| Disputes / chargebacks | NOT deducted. A successful charge later disputed still counts in volume. Disputes are tracked in viv_dispute_rate and viv_chargeback_rate. |
| Failed / declined payments | Excluded. Only StatusId = F rows count. E (Error / declined), M (Max attempts), X (Cancelled / 3DS abandoned) excluded. |
| 3DS 2 treatment | Both frictionless and challenge-completed flows count. Customer-abandoned 3DS challenges are StatusId = X and excluded; tracked in viv_threedsecure_abandon_rate. |
| Recurring vs one-time | Both included. Viva Recurring Payments tokenized rebills (Type = Capture against an original token) are indistinguishable from one-time captures here. |
| Channels | Online + POS + recurring + pay-by-link unified. Viva’s omnichannel reporting feature treats all four channels as the same Type = Capture rail. |
| Payout timing | Per transaction date (when the customer paid), NOT per payout date. Viva-IBAN merchants typically settle in minutes (instant rail); non-Viva-IBAN settle T+1 to T+3 via SEPA. See viv_avg_settlement_days. |
| Time window | 30D vsP (default 30D vs the prior 30D). |
| Alert trigger | drop >15% vsP. |
| Roles | owner, finance, operations |
Calculation
Calculated automatically from your Viva Payments data. See the At a glance summary above for what the metric tracks and the worked example below for a typical reading.Worked example
A French DTC subscription-coffee retailer (“Café Lumière”) operates a Shopify storefront with Viva Smart Checkout as the primary EU processor, plus one Smart POS at their Lyon roastery counter. They also use Viva Recurring Payments for monthly subscription rebills. The 30-day window covers 03 Apr 26 to 02 May 26.| Channel | Transactions | Amount | Currency | StatusId | Notes |
|---|---|---|---|---|---|
| Online checkout, French customers | 3,820 sessions | EUR 248,300 | EUR | F | Smart Checkout, 3DS 2 frictionless 81% |
| Online checkout, Belgian + Dutch | 410 sessions | EUR 27,400 | EUR | F | Smart Checkout, EUR settlement |
| Online checkout, German | 380 sessions | EUR 31,200 | EUR | F | Smart Checkout, EUR settlement |
| Online checkout, UK | 220 sessions | GBP 19,800 | GBP | F | Settled in GBP, no FX needed |
| Recurring monthly rebills | 1,940 rebills | EUR 58,200 | EUR | F | Tokenized card-on-file |
| Smart POS Lyon roastery | 312 captures | EUR 12,400 | EUR | F | Card-present, mostly debit |
| Pay-by-link (B2B invoices) | 28 captures | EUR 18,400 | EUR | F | Sent to wholesale customers |
| Failed / declined | 286 attempts | - | - | E + M | Excluded |
| 3DS abandoned | 142 attempts | - | - | X | Excluded |
| Refunds (period) | 86 refunds | EUR 4,200 | EUR | - | Tracked separately |
- Recurring is 14.7% of EUR volume. Subscription rebills (EUR 58,200) are silently the second-largest channel. A 1pp drop in subscription retention costs roughly EUR 580/month at this volume; this is why subscription-led merchants treat Viva Recurring as a first-class metric.
- Pay-by-link is small but high-AOV. 28 captures generating EUR 18,400 implies an average ticket of EUR 657, materially higher than the EUR 65 e-shop average. Pay-by-link revenue per transaction is structurally higher because it’s used for B2B invoicing where amounts are larger and friction is lower.
- GBP listed alongside EUR rather than converted. A finance team looking for “single rolled-up EUR” won’t find it here; that view lives in
viva_revenue_by_country. The omission is intentional, FX-converted volume distorts treasury planning where settlement actually occurs in the native currency. - POS is the structural floor. The Lyon counter (EUR 12,400) is 3.1% of EUR volume but the Lyon team uses it for daily cash flow planning. Treating volume as a single number masks the operating reality that POS settles same-day-end while online settles within minutes via Viva-IBAN.
- 3DS 2 frictionless rate at 81% is healthy. PSD2 SCA forces 3DS challenges on EEA card-not-present payments above EUR 30. Viva’s Smart Checkout achieves frictionless on 75 to 85% of healthy traffic by feeding strong device + transaction risk data to issuers. The 19% who got challenges and the 142 abandons live in
viv_threedsecure_abandon_rate.
Sibling cards merchants should reference together
| Card | Why merchants reach for it next to Total Volume |
|---|---|
viva_total_revenue | Same arithmetic, framed as merchant revenue rather than rail volume. |
viv_total_transactions | Transaction count over the same window. Volume ÷ count = average transaction. |
viv_volume_trend | This metric trended daily, the spike + dip detection view. |
viv_avg_transaction | The per-transaction view, the denominator-aware reading. |
viva_net_revenue | Same volume net of refunds, the closer-to-P&L view. |
viv_payouts_pending | What’s in flight from this volume but not yet in your bank. |
viv_avg_settlement_days | How long volume waits before reaching the bank. |
Stripe stripe_total_revenue / PayPal pp_total_volume | Same archetype on competing rails. Multi-PSP merchants sum these. |
Shopify total_revenue / BC total_revenue | Upstream commerce view. Viva volume should reconcile to commerce_total minus non-Viva orders. |
Reconciling against the vendor’s own dashboard
Where to look in the Viva Payments Dashboard: Sign in at viva.com/business/account/login. Closest comparable views:Viva Business → Sales → Transactions (filter by date range; “Status: Successful”)
Viva Business → Sales → Reports → Channels (per-channel split: online / Smart POS / recurring / pay-by-link)The headline tile on the Sales overview also shows period revenue. Other Viva views to be aware of:
- Settlements view (Sales → Settlements). Post-reserve, post-fee balance. Always lower than this card. Use
viva_net_revenueand the effective fee rate to bridge. - Disputes view (Sales → Disputes). Tracks chargeback cases, not transaction volume.
- Marketplace Splits view (Business → Marketplace, where enabled). For platform merchants, shows post-split residual; this card shows gross volume before splits.
- Smart POS terminal reports (Devices → Terminals). Per-terminal end-of-day reports. Subset of this card.
| Reason | Direction | Why |
|---|---|---|
| Time zone | Boundary days off | Viva Dashboard renders in your account’s configured timezone (Greek merchants default to Athens EET / EEST, UK merchants Europe/London). Vortex IQ uses UTC for period boundaries. Athens is UTC+2 / UTC+3, so “today” cards can shift by 2 to 3 hours of activity. |
| Settlement reserves | Theirs lower (Settlements view) | Viva can hold a small reserve on new merchants or seasonal businesses; the Settlements view nets this off. This card is gross of reserves. |
| 3DS late completion | Ours stable, theirs may move retroactively | A 3DS challenge that the customer completes hours later flips from “pending” to StatusId = F retroactively in the Dashboard. Our snapshot reflects state at sync. The gap closes within 24 hours. |
| Multi-currency arithmetic | Ours stacks, Viva offers FX-converted view | Viva Dashboard offers a “Total in EUR equivalent” toggle using daily published FX. This card preserves native currency. |
| API rate limits | Ours lower for very high-volume merchants | Viva Payments API caps at typically 10 requests/sec; pagination at 100 transactions per page. For merchants doing tens of thousands of transactions/day, the freshest 5 to 15 minutes may be deferred to the next sync. |
| Refresh lag | Ours lower for “today” | The most recent 5 to 15 minutes of transactions may not yet be indexed. Yesterday and earlier are caught up. |
| Comparison | Expected relationship | When divergence is legitimate |
|---|---|---|
viv_total_volume ↔ shopify.total_revenue | viva ≤ shopify | Shopify includes orders paid via Stripe, PayPal, Apple Pay direct, Klarna, gift cards, manual bank transfer, none of which touch Viva. For a Mediterranean Shopify store using Viva as primary processor, expect Viva to cover 70 to 95% of online revenue. |
viv_total_volume ↔ bigcommerce.total_revenue | viva ≤ bigcommerce | Same logic. BC supports many gateways; each one displaces Viva volume. |
viv_total_volume ↔ adobe_commerce.total_revenue | viva ≤ adobe_commerce | Same logic. Adobe Commerce stores in Greece often run Viva alongside legacy gateway. |
viv_total_volume + stripe.stripe_total_revenue + paypal.pp_total_volume | ≈ commerce_total_revenue (in matching currency) | The three payment-processor volumes summed should approach the commerce platform total. They should never exceed it; if they do, suspect double-counting (marketplace split routed through both rails) or refund/chargeback timing mismatch. |
Known limitations / merchant FAQs
Reconciliation questions (“why doesn’t this match the Viva Dashboard or my bank?”) are answered in the Reconciling against the vendor’s own dashboard section above. Below are the questions that aren’t reconciliation.“Total Volume vs Total Revenue, what’s the difference?” Arithmetically the same when both are scoped to
StatusId = F. The labels reflect different audiences. Total Revenue is finance-team language (the merchant top line); Total Volume is treasury and ops language (the volume of money flowing across the rail before it becomes the merchant’s). Same number, two lenses. Some agencies prefer to see both in their dashboards, hence both cards.
“Viva is owned by JP Morgan now. Does anything change for me operationally?”
No, not at the API or merchant-account level. JP Morgan Chase acquired 49% of Viva.com in 2023 with an option to ramp to majority. Day-to-day operations (Viva Business Dashboard, Smart Checkout API, Smart POS terminals, settlement rails, fee structures, e-money licences) all continue under Viva’s existing entities. From a CFO perspective the practical implication is balance-sheet credibility (a globally systemic bank backs the platform), not workflow change. Volume figures are unaffected.
“Why is Viva often cheaper than Stripe for my Greek or Mediterranean store?”
Three reasons. (1) The Interchange Fee Regulation caps EU intra-EEA debit interchange at 0.2% and credit at 0.3%; Viva passes more of this saving through to SMBs in Greece, Cyprus, Spain, Italy, Portugal, Romania than Stripe does. (2) Viva has direct connections to Greek and Cyprus issuing banks; Stripe usually routes Greek issuers via a non-Greek acquirer, which adds basis points. (3) Greek-language support and on-the-ground POS hardware are structurally cheaper for the merchant to operate.
“Does Viva settle natively in multiple currencies?”
Yes, in 13+ currencies depending on merchant account jurisdiction and the IBAN currency you’ve configured. A Greek-headquartered merchant accepting GBP from UK customers can settle directly to a GBP IBAN without FX, materially cheaper than Stripe’s model where everything either converts to home currency at Stripe FX (1% spread) or sits in a Stripe Treasury balance. This card respects native settlement.
“Why does this number include POS captures? My CFO wants online-only.”
Viva’s defining product feature is omnichannel unified reporting, POS and online both flow through the same Payments API as Type = Capture. To filter to online only, use the SourceCode field. The Viva Dashboard’s Sales → Reports → Channels view already provides the split. A per-channel split card is on the roadmap.
“3DS 2 frictionless rate, what’s a healthy number?”
75 to 85% frictionless on EEA card-not-present traffic is the live benchmark for healthy Smart Checkout integrations. Below 70%, your device fingerprint or risk data feed to issuers is weak (often a misconfigured MerchantTrxId or missing browser data). Above 90% suggests you’re in issuer trusted-merchant allowlists, which is excellent. Track via viv_threedsecure_abandon_rate.
“My recurring subscription rebills, do those count here?”
Yes. Viva Recurring Payments uses tokenized card-on-file (network-token-backed where the issuer supports VTS / MDES) and rebills as Type = Capture against the original token. They’re indistinguishable from one-time captures in this card. Track them separately via the RecurringTransactionId field; a dedicated Subscription Volume card is on the roadmap.
“What’s the difference between Viva volume and Viva net deposited?”
Three deductions between this card and your IBAN: (1) Viva’s blended fee (typically 0.8 to 1.4% for EU cards), (2) refunds processed in the same window, (3) settlement timing (transactions on the last day of the period may settle the next day for non-Viva-IBAN accounts). Use Net Revenue and the Settlements view together to bridge.
“What about Viva’s API rate limits?”
Production tier: typically 10 requests/sec, 600/min, with bursts permitted. For merchants doing more than 50,000 transactions/day, the engine batches reads to stay under cap; the practical effect is a 5 to 15-minute lag on the freshest transactions. If you’re consistently above the rate limit, contact Viva merchant support for a tier upgrade.