@12-apps/payments-e2e 1.4.0 → 1.5.0

package/README.md

@@ -4,9 +4,10 @@ The buyer journeys for the payments checkout, as Gherkin you run **against your
 own app**.
 
 Mounting `createPaymentFlows` gives you a checkout. This gives you its
-end-to-end coverage: twenty scenarios across seven features — PIX, card, hosted
-hand-off and return, provider failover, issuer declines, an unresolved charge, a
-store that cannot charge at all, and per-provider screens. You implement one
+end-to-end coverage: twenty-seven scenarios across ten features — PIX, card,
+digital wallets, hosted hand-off and return, provider failover, issuer
+declines, an unresolved charge, a store that cannot charge at all,
+per-provider screens, and saving a card outside checkout. You implement one
 port and add three lines of config. Nothing is copied, so a scenario added here
 later runs in your app on the next version bump.
 
@@ -84,12 +85,33 @@ files do not change either way.
 `pix-only` · `card` · `both-methods` · `hosted` · `awaiting` · `settles` ·
 `declined` · `unresolved` · `unavailable` · `no-provider` ·
 `no-provider-remedy` · `payments-off` · `two-mintable` · `redirect-head` ·
-`google-pay` · `apple-pay` · `apple-pay-unsupported` · `screen-on-page` ·
-`screen-handoff` · `screen-undeclared` · `screen-unknown`
+`google-pay` · `apple-pay` · `apple-pay-unsupported` · `wallet` ·
+`activation` · `screen-on-page` · `screen-handoff` · `screen-undeclared` ·
+`screen-unknown`
 
 Adding a member is a breaking change for hosts, deliberately: a scenario needing
 a store nobody can build is a scenario that silently never runs.
 
+`wallet` (added for FUT-183/FUT-478) is one of two members that are **not a
+checkout**: `open(page, 'wallet')` must land the buyer on the package's
+manage-cards surface (`screens.ManageCards` from `createPaymentFlows`) at a
+store whose single provider can vault — the chain head declares the adapter
+`vault` seam, the connection runs in stub mode, and the wallet starts empty.
+The journey types the shared `DECLINE_PAN` for the refusal path, so no store
+flag decides the outcome; the card does. Hosts upgrading across this version
+must add the member to their `open` mapping or their world stops compiling —
+which is the point.
+
+`activation` (added for FUT-689) is the other, and the first **admin**-side
+shape: `open(page, 'activation')` must land the OWNER on the settings panel of
+one provider that declares `activationCharge`, connected in stub mode and
+never charged — the sales switch starts locked off. The host's
+`renderVerification` slot must render the shared card form plus the
+`activation-*` test ids `src/steps/activation.steps.ts` documents (pay button,
+outcome, refund line, and the raw enable-attempt probe pair). As in `wallet`,
+the typed card decides the outcome: `DECLINE_PAN` is refused with a named
+reason, anything else pays the cent and gets it refunded.
+
 ## Why this package ships compiled JavaScript
 
 Its siblings export raw `.ts` through their `exports` map, because an

package/dist/steps/activation.steps.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=activation.steps.d.ts.map

package/dist/steps/activation.steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.steps.d.ts","sourceRoot":"","sources":["../../src/steps/activation.steps.ts"],"names":[],"mappings":""}

package/dist/steps/activation.steps.js

@@ -0,0 +1,74 @@
+import { expect } from '@playwright/test';
+import { DECLINE_PAN, fillCard, fillCpf } from '../helpers/checkout.js';
+import { paymentsWorld } from '../world.js';
+import { Given, Then, When } from './fixtures.js';
+/**
+ * ACTIVATING A PROVIDER (FUT-463, made real for every SDK provider by
+ * FUT-689) — the merchant admin's side of the till.
+ *
+ * The package renders the switch and its lock (`payments-enabled-toggle`,
+ * `payments-enable-hint`, `payments-status`); the activation step itself is
+ * HOST-owned, rendered into the `renderVerification` slot. So these steps
+ * read two vocabularies:
+ *
+ *   - the package's own test ids, which mean the same thing in any host;
+ *   - the activation-step contract a host's slot must render — the shared
+ *     card form (`card-number`…, `buyer-cpf`) plus `activation-pay`,
+ *     `activation-result`, `activation-refunded`, `activation-error`, and the
+ *     fixture probe pair `activation-enable-attempt` /
+ *     `activation-enable-refusal` (a raw enable request and the refusal it
+ *     gets, the same affordance the wire probe is).
+ *
+ * The card the owner types decides the outcome, exactly as in the wallet
+ * journey: the shared `DECLINE_PAN` is refused with a named reason, any other
+ * valid card pays the cent and gets it back.
+ */
+/** The "Recebendo vendas" switch — MUI puts the state on the inner checkbox. */
+function salesSwitch(page) {
+    return page.getByTestId('payments-enabled-toggle').getByRole('checkbox');
+}
+Given('the owner opens the settings of a connected but unproven provider', async ({ page }) => {
+    await paymentsWorld().open(page, 'activation');
+});
+Then('the sales switch is locked off until a real charge lands', async ({ page }) => {
+    await expect(salesSwitch(page)).toBeDisabled();
+    // The package's own lock hint — the quoted words are its pt-BR product copy.
+    await expect(page.getByTestId('payments-enable-hint')).toContainText('depois dos 3 passos');
+});
+When('the owner tries to force the provider on anyway', async ({ page }) => {
+    await page.getByTestId('activation-enable-attempt').click();
+});
+Then('the enable request is refused as unproven', async ({ page }) => {
+    // The package's own refusal, by name: the server said no, not the screen.
+    await expect(page.getByTestId('activation-enable-refusal')).toContainText('409');
+    await expect(page.getByTestId('activation-enable-refusal')).toContainText('UnprovenProviderError');
+});
+When('the owner pays the verification charge with their card', async ({ page }) => {
+    await fillCard(page);
+    await fillCpf(page);
+    await page.getByTestId('activation-pay').click();
+});
+When('the owner pays the verification charge with a refused card', async ({ page }) => {
+    await fillCard(page, DECLINE_PAN);
+    await fillCpf(page);
+    await page.getByTestId('activation-pay').click();
+});
+Then('the provider is proven and receiving sales', async ({ page }) => {
+    // VERIFICADO is reserved for a landed charge — the chip's one green word.
+    await expect(page.getByTestId('payments-status')).toHaveText('VERIFICADO');
+    await expect(salesSwitch(page)).toBeChecked();
+});
+Then('the screen says the cent came back', async ({ page }) => {
+    // The refund fact, in the screen's own pt-BR copy.
+    await expect(page.getByTestId('activation-refunded')).toContainText('estornado');
+});
+Then("the refusal names the provider's reason", async ({ page }) => {
+    await expect(page.getByTestId('activation-error')).toContainText('recusada');
+    await expect(page.getByTestId('activation-error')).toContainText('CARD_DECLINED');
+});
+Then('the provider received each attempt as its own charge', async ({ page }) => {
+    // Two charges REACHED the provider: a retry that replayed the first
+    // refusal would have left this at one.
+    await expect(paymentsWorld().wire.providerChargeCount(page)).toHaveText('2');
+});
+//# sourceMappingURL=activation.steps.js.map

package/dist/steps/activation.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.steps.js","sourceRoot":"","sources":["../../src/steps/activation.steps.ts"],"names":[],"mappings":"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"}

package/dist/steps/saved-card-wallet.steps.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=saved-card-wallet.steps.d.ts.map

package/dist/steps/saved-card-wallet.steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-card-wallet.steps.d.ts","sourceRoot":"","sources":["../../src/steps/saved-card-wallet.steps.ts"],"names":[],"mappings":""}

package/dist/steps/saved-card-wallet.steps.js

@@ -0,0 +1,65 @@
+import { expect } from '@playwright/test';
+import { DECLINE_PAN, fillCard } from '../helpers/checkout.js';
+import { paymentsWorld } from '../world.js';
+import { Given, Then, When } from './fixtures.js';
+/**
+ * SAVING A CARD WITHOUT BUYING (FUT-183, over FUT-478's buyer vault rows).
+ *
+ * A separate file from `carteira.steps.ts` on purpose: that one is the DIGITAL
+ * wallets (Google Pay / Apple Pay) — a faster way to pay inside checkout.
+ * These steps are the SAVED-CARD wallet: the package's manage-cards surface,
+ * reached outside any purchase, where nothing is charged at all.
+ *
+ * Every Then reads a test id the package's own vault screens render
+ * (`manage-cards*`, `add-card*`), plus the shared card form ids — so the
+ * journey means the same thing in any host that mounts `screens.ManageCards`.
+ * The card the buyer types decides the outcome: the shared `DECLINE_PAN` is
+ * the one the stub refuses at validation.
+ */
+Given("the shopper opens the store's card wallet", async ({ page }) => {
+    await paymentsWorld().open(page, 'wallet');
+});
+When('she decides to add a card', async ({ page }) => {
+    await page.getByTestId('manage-cards-add').click();
+    // Wait for the FORM, not merely the click: `/cards/begin` runs in between,
+    // and typing into a form that has not mounted is the flake this avoids.
+    await expect(page.getByTestId('add-card')).toBeVisible();
+});
+When('she fills in the card and saves it', async ({ page }) => {
+    await fillCard(page);
+    await page.getByTestId('add-card-save').click();
+});
+When('she tries to save a refused card', async ({ page }) => {
+    await fillCard(page, DECLINE_PAN);
+    await page.getByTestId('add-card-save').click();
+});
+Then('the card is stored and appears in the list', async ({ page }) => {
+    await expect(page.getByTestId('add-card-saved')).toBeVisible();
+    await expect(page.getByTestId('manage-cards-list')).toBeVisible();
+    await expect(page.getByTestId('manage-cards-empty')).toHaveCount(0);
+});
+Then('the list shows only the brand and the last digits', async ({ page }) => {
+    // Display metadata ONLY. The vault token — the thing that can charge —
+    // never reaches this screen; what she reads back is brand + last4 + expiry.
+    // The quoted strings are the screen's pt-BR product copy, asserted as-is.
+    const list = page.getByTestId('manage-cards-list');
+    await expect(list).toContainText('••••');
+    await expect(list).toContainText('Validade');
+});
+Then('the refusal explains why and the form stays on screen', async ({ page }) => {
+    // The endpoint's own reason, and the form kept editable under it — wiping
+    // her input to say the card was refused would be the screen working
+    // against her. The asserted word is the pt-BR product copy of the reason.
+    await expect(page.getByTestId('add-card-error')).toBeVisible();
+    await expect(page.getByTestId('add-card-error')).toContainText('cartão');
+    await expect(page.getByTestId('card-number')).toBeVisible();
+});
+Then('the wallet still holds no card', async ({ page }) => {
+    await expect(page.getByTestId('manage-cards-empty')).toBeVisible();
+    await expect(page.getByTestId('manage-cards-list')).toHaveCount(0);
+});
+Then('the empty wallet invites saving the first card', async ({ page }) => {
+    await expect(page.getByTestId('manage-cards-empty')).toBeVisible();
+    await expect(page.getByTestId('manage-cards-add')).toBeVisible();
+});
+//# sourceMappingURL=saved-card-wallet.steps.js.map

package/dist/steps/saved-card-wallet.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saved-card-wallet.steps.js","sourceRoot":"","sources":["../../src/steps/saved-card-wallet.steps.ts"],"names":[],"mappings":"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"}

package/dist/world.d.ts

@@ -76,6 +76,26 @@ export type PaymentsStore =
  * fallback rule — no button, and the card form stays the way to pay.
  */
  | 'apple-pay-unsupported'
+/**
+ * The buyer's saved-card WALLET (FUT-183 over FUT-478), not a checkout: the
+ * host opens the package's manage-cards surface at a store whose provider
+ * can vault — one mintable chain entry with the vault seam, connected in
+ * stub mode — and the wallet starts EMPTY. The card the buyer types decides
+ * the outcome: the package's `DECLINE_PAN` is refused at validation, any
+ * other valid card is stored. (Not a digital wallet — those are the
+ * `google-pay` / `apple-pay` shapes above.)
+ */
+ | 'wallet'
+/**
+ * A merchant ADMIN surface, not a checkout (FUT-463/FUT-689): the settings
+ * screen of ONE provider that declares the activation charge, connected in
+ * stub mode and never charged — so the sales switch starts locked off. The
+ * host lands the owner on that provider's own panel, whose host-rendered
+ * activation step shows the shared card form (`card-number`…, `buyer-cpf`)
+ * plus the `activation-*` test ids the steps file documents. The card the
+ * owner types decides the outcome, exactly as in the `wallet` shape.
+ */
+ | 'activation'
 /** Declares the on-page screen (FUT-596). */
  | 'screen-on-page'
 /** Declares the hand-off screen (FUT-596). */

package/dist/world.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"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"}

package/dist/world.js.map

@@ -1 +1 @@
-{"version":3,"file":"world.js","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AAsJA,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0EAA0E;YACxE,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../src/world.ts"],"names":[],"mappings":"AA0KA,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAoB;IACtD,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0EAA0E;YACxE,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/features/activating-a-provider.feature

@@ -0,0 +1,29 @@
+@journey @activation
+Feature: Activating a provider
+
+  "Connected" and "can charge" are different facts, and the gap between them
+  is where a store ships broken: credentials authenticate, the switch flips,
+  and the first real shopper is refused. So a provider that declares the
+  activation charge EARNS its switch — one cent through the owner's own card,
+  on the same rails a shopper's money takes, refunded on the spot — and stays
+  off until that cent has landed.
+
+  Background:
+    Given the owner opens the settings of a connected but unproven provider
+
+  Scenario: Enabling without proof is refused
+    Then the sales switch is locked off until a real charge lands
+    When the owner tries to force the provider on anyway
+    Then the enable request is refused as unproven
+
+  Scenario: Paying the one-cent verification enables the provider
+    When the owner pays the verification charge with their card
+    Then the provider is proven and receiving sales
+    And the screen says the cent came back
+
+  Scenario: A refused card names the reason and a retry is a fresh charge
+    When the owner pays the verification charge with a refused card
+    Then the refusal names the provider's reason
+    When the owner pays the verification charge with their card
+    Then the provider is proven and receiving sales
+    And the provider received each attempt as its own charge

package/features/saving-a-card.feature

@@ -0,0 +1,29 @@
+@journey @saved-cards
+Feature: Saving a card without buying
+
+  Saving a card is not buying: no order exists, nothing is charged, and the
+  card still travels its usual path — the browser mints the token and the
+  provider validates it. What the shopper reads back is only what is fit to
+  show: the brand and the last digits. The token that can charge stays on the
+  store's side and never reaches this screen.
+
+  There is deliberately no delete button here: taking a card off the list is
+  between the store and the provider, not a tap on this screen.
+
+  Background:
+    Given the shopper opens the store's card wallet
+
+  Scenario: Saving a card without buying anything
+    When she decides to add a card
+    And she fills in the card and saves it
+    Then the card is stored and appears in the list
+    And the list shows only the brand and the last digits
+
+  Scenario: A card refused at validation explains why and stays off the list
+    When she decides to add a card
+    And she tries to save a refused card
+    Then the refusal explains why and the form stays on screen
+    And the wallet still holds no card
+
+  Scenario: The empty wallet invites saving the first card
+    Then the empty wallet invites saving the first card

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/payments-e2e",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "The payments buyer journeys, as Gherkin a host runs against its own app",
   "repository": {