@nauticana/sail 1.1.12 → 1.1.14

package/src/component/agency/agency_payout_profile.html

@@ -0,0 +1,49 @@
+@if (loading()) {
+  <mat-spinner diameter="36" aria-label="Loading payout profile"></mat-spinner>
+} @else {
+  <section class="agency-payout-profile__selection">
+    <h2>Payout destination</h2>
+    @if (profile(); as current) {
+      <p class="agency-payout-profile__current" role="status">
+        Current: {{ current.countryCode }} / {{ current.currency }} ({{ current.provider }})
+      </p>
+    }
+
+    @if (destinations().length > 0) {
+      <mat-form-field appearance="outline">
+        <mat-label>Destination</mat-label>
+        <mat-select [value]="selectedDestinationID()" (selectionChange)="choose($event)">
+          @for (destination of destinations(); track destination.userBankInfoId) {
+            <mat-option [value]="destination.userBankInfoId">
+              {{ destination.countryCode }} / {{ destination.currency }} ({{ destination.provider }})
+            </mat-option>
+          }
+        </mat-select>
+      </mat-form-field>
+      <button matButton="filled" type="button" [disabled]="!selectedDestinationID() || saving()" (click)="save()">
+        Use for agency payouts
+      </button>
+    } @else if (!onboarding()) {
+      <p>No fully onboarded payout destination is available for this business.</p>
+    }
+
+    <button matButton type="button" [disabled]="saving()" (click)="onboarding.set(!onboarding())">
+      {{ onboarding() ? 'Hide account setup' : 'Set up a payout account' }}
+    </button>
+
+    @if (pending()) {
+      <p role="status">The provider is waiting for account confirmation.</p>
+    }
+    @if (errorMessage()) {
+      <p class="agency-payout-profile__error" role="alert">{{ errorMessage() }}</p>
+    }
+  </section>
+
+  @if (onboarding()) {
+    <sail-payout-provider-onboarding
+      [showBack]="false"
+      (linked)="onboardingComplete()"
+      (pending)="pending.set(true)"
+      (skipped)="onboarding.set(false)" />
+  }
+}

package/src/component/agency/agency_payout_profile.ts

@@ -0,0 +1,101 @@
+import { ChangeDetectionStrategy, Component, OnInit, inject, output, signal } from '@angular/core';
+import { MatButtonModule } from '@angular/material/button';
+import { MatFormFieldModule } from '@angular/material/form-field';
+import { MatProgressSpinnerModule } from '@angular/material/progress-spinner';
+import { MatSelectChange, MatSelectModule } from '@angular/material/select';
+import { AgencyPayoutDestination, AgencyPayoutProfile } from '../../model/agency';
+import { AgencyService } from '../../service/agency.service';
+import { errorDetail } from '../../util/errors';
+import { PayoutProviderOnboardingComponent } from '../payout/provider_onboarding';
+
+/**
+ * Self-service selection of the fully onboarded destination that receives
+ * agency commission payouts. Routes and page composition remain app-owned.
+ */
+@Component({
+  selector: 'sail-agency-payout-profile',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [
+    MatButtonModule,
+    MatFormFieldModule,
+    MatProgressSpinnerModule,
+    MatSelectModule,
+    PayoutProviderOnboardingComponent,
+  ],
+  templateUrl: './agency_payout_profile.html',
+  host: { class: 'agency-payout-profile' },
+})
+export class AgencyPayoutProfileComponent implements OnInit {
+  readonly selected = output<AgencyPayoutProfile>();
+
+  private readonly agency = inject(AgencyService);
+
+  readonly loading = signal(true);
+  readonly saving = signal(false);
+  readonly onboarding = signal(false);
+  readonly pending = signal(false);
+  readonly errorMessage = signal('');
+  readonly profile = signal<AgencyPayoutProfile | null>(null);
+  readonly destinations = signal<AgencyPayoutDestination[]>([]);
+  readonly selectedDestinationID = signal<number | null>(null);
+
+  ngOnInit(): void {
+    this.reload();
+  }
+
+  reload(): void {
+    this.loading.set(true);
+    this.errorMessage.set('');
+    this.agency.payoutProfile().subscribe({
+      next: ({ profile, destinations }) => {
+        const available = destinations ?? [];
+        this.profile.set(profile);
+        this.destinations.set(available);
+        this.selectedDestinationID.set(
+          available.some((item) => item.userBankInfoId === profile?.userBankInfoId)
+            ? profile!.userBankInfoId
+            : available[0]?.userBankInfoId ?? null,
+        );
+        this.loading.set(false);
+      },
+      error: (error: unknown) => {
+        this.loading.set(false);
+        this.errorMessage.set(errorDetail(error, 'Could not load the payout profile.'));
+      },
+    });
+  }
+
+  choose(event: MatSelectChange): void {
+    this.selectedDestinationID.set(Number(event.value));
+  }
+
+  save(): void {
+    const destinationID = this.selectedDestinationID();
+    if (!destinationID || this.saving()) return;
+    this.saving.set(true);
+    this.errorMessage.set('');
+    this.agency.setPayoutProfile(destinationID).subscribe({
+      next: () => {
+        this.saving.set(false);
+        this.agency.payoutProfile().subscribe({
+          next: ({ profile, destinations }) => {
+            this.profile.set(profile);
+            this.destinations.set(destinations ?? []);
+            if (profile) this.selected.emit(profile);
+          },
+          error: (error: unknown) => this.errorMessage.set(errorDetail(error, 'The destination was saved, but its status could not be refreshed.')),
+        });
+      },
+      error: (error: unknown) => {
+        this.saving.set(false);
+        this.errorMessage.set(errorDetail(error, 'Could not select the payout destination.'));
+      },
+    });
+  }
+
+  onboardingComplete(): void {
+    this.onboarding.set(false);
+    this.pending.set(false);
+    this.reload();
+  }
+}

package/src/component/agency/agency_status_banner.html

@@ -0,0 +1,9 @@
+@if (pending()) {
+  <div class="agency-status-banner__notice" data-agency-status="pending" role="status">
+    {{ pendingMessage() }}
+  </div>
+} @else if (suspended()) {
+  <div class="agency-status-banner__notice" data-agency-status="suspended" role="alert">
+    {{ suspendedMessage() }}
+  </div>
+}

package/src/component/agency/agency_status_banner.ts

@@ -0,0 +1,24 @@
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+import { AgencyProfile } from '../../model/agency';
+
+@Component({
+  selector: 'sail-agency-status-banner',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  templateUrl: './agency_status_banner.html',
+  host: { class: 'agency-status-banner' },
+})
+export class AgencyStatusBannerComponent {
+  readonly profile = input<AgencyProfile | null>(null);
+  readonly pendingMessage = input('Agency approval is pending. Client management is read-only until approval.');
+  readonly suspendedMessage = input('Agency access is suspended. New invitations and earnings are paused.');
+
+  readonly pending = computed(() => {
+    const profile = this.profile();
+    return profile !== null && !profile.approvedAt && !profile.suspended;
+  });
+  readonly suspended = computed(() => this.profile()?.suspended === true);
+  readonly canManage = computed(() => {
+    const profile = this.profile();
+    return profile !== null && Boolean(profile.approvedAt) && !profile.suspended;
+  });
+}

package/src/component/agency/commission_ledger.html

@@ -0,0 +1,19 @@
+@if (entries().length > 0) {
+  <div class="commission-ledger__table-wrap">
+    <table class="commission-ledger__table">
+      <thead><tr><th>Client</th><th>Service period</th><th>Amount</th><th>Status</th></tr></thead>
+      <tbody>
+        @for (entry of entries(); track entry.id) {
+          <tr [class.commission-ledger__reversal]="entry.entryType === 'R'">
+            <td>{{ entry.clientName }}</td>
+            <td>{{ entry.periodStart | date: 'yyyy-MM-dd':'UTC' }} – {{ entry.periodEnd | date: 'yyyy-MM-dd':'UTC' }}</td>
+            <td>{{ format(entry.amountMinor, entry.currency) }}</td>
+            <td><sail-status-chip domain="agency_commission_status" [value]="entry.status" /></td>
+          </tr>
+        }
+      </tbody>
+    </table>
+  </div>
+} @else if (emptyMessage()) {
+  <p class="commission-ledger__empty">{{ emptyMessage() }}</p>
+}

package/src/component/agency/commission_ledger.ts

@@ -0,0 +1,18 @@
+import { DatePipe } from '@angular/common';
+import { ChangeDetectionStrategy, Component, input } from '@angular/core';
+import { AgencyEarningEntry } from '../../model/agency';
+import { formatMinorCurrency } from '../../util/money';
+import { StatusChipComponent } from '../billing/status_chip';
+
+@Component({
+  selector: 'sail-commission-ledger',
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  imports: [DatePipe, StatusChipComponent],
+  templateUrl: './commission_ledger.html',
+  host: { class: 'commission-ledger' },
+})
+export class CommissionLedgerComponent {
+  readonly entries = input<AgencyEarningEntry[]>([]);
+  readonly emptyMessage = input('No commission activity yet.');
+  readonly format = formatMinorCurrency;
+}

package/src/component/login/login_component.html

@@ -38,11 +38,17 @@
     <div class="auth-actions">
       <a routerLink="/login/chpass">I forgot my password</a>
     </div>
-    @if (guiConfig.loginFooterLinks && guiConfig.loginFooterLinks.length > 0) {
+    @if (guiConfig.loginFooterLinks?.length || guiConfig.termsUrl || guiConfig.privacyPolicyUrl) {
       <div class="auth-footer">
-        @for (link of guiConfig.loginFooterLinks; track link.routerLink) {
+        @for (link of guiConfig.loginFooterLinks ?? []; track link.routerLink) {
           <a [routerLink]="link.routerLink">{{ link.label }}</a>
         }
+        @if (guiConfig.termsUrl) {
+          <a [href]="guiConfig.termsUrl" target="_blank" rel="noopener">Terms of Service</a>
+        }
+        @if (guiConfig.privacyPolicyUrl) {
+          <a [href]="guiConfig.privacyPolicyUrl" target="_blank" rel="noopener">Privacy Policy</a>
+        }
       </div>
     }
   </div>

package/src/component/payout/bank_info_form.ts

@@ -26,8 +26,10 @@ export const DEFAULT_COUNTRY_PROFILES: CountryProfile[] = [
  *
  * Captures the basis `user_bank_info` fields (country, currency, account
  * holder, tax id, billing address, agreement). Emits the form value via
- * `(submitted)` — the consumer decides whether to POST directly to
- * /api/v1/user_bank_info or pipe through its own registration service.
+ * `(submitted)` — first-time setup POSTs through the app's registration
+ * service; CHANGES to an existing destination go through
+ * PayoutService.replaceBankInfo (atomic version replacement), never a
+ * generic CRUD edit.
  *
  * Ships no CSS — the consuming app styles the classes globally.
  *
@@ -58,7 +60,11 @@ export class PayoutBankInfoFormComponent {
   /** When true, the back button renders alongside submit. */
   readonly showBack = input(true);
 
-  /** Emitted on submit; payload maps 1:1 to basis user_bank_info columns. */
+  /**
+   * Emitted on submit as application-layer input. The consumer must use its
+   * registration service for first-time setup or PayoutService.replaceBankInfo
+   * for changes; never send this payload through generic CRUD.
+   */
   readonly submitted = output<BankInfoFormValue>();
   /** Emitted when the user clicks Back. */
   readonly back = output<void>();

package/src/component/payout/provider_onboarding.ts

@@ -14,12 +14,13 @@ import { ReusableAccount } from '../../model/appdata';
  * two paths:
  *   1. Reuse an existing provider account from another partner row
  *      (zero-KYC; calls /api/v1/payout/reusable/link).
- *   2. Hand off to the provider's hosted-KYC page
- *      (/api/v1/payout/onboard/start).
+ *   2. Start provider onboarding (/api/v1/payout/onboard/start), then
+ *      either hand off to a hosted-KYC page or emit `pending` when the
+ *      provider continues asynchronously without a hosted URL.
  *
- * Routing is consumer-owned via the `(linked)` / `(skipped)` outputs —
- * the component itself never calls Router. Optional `title` and
- * `skipLabel` inputs cover the common UX strings.
+ * Routing is consumer-owned via the `(linked)`, `(pending)`, and
+ * `(skipped)` outputs — the component itself never calls Router.
+ * Optional `title` and `skipLabel` inputs cover the common UX strings.
  *
  * Ships no CSS — the consuming app styles the classes globally.
  *
@@ -47,6 +48,13 @@ export class PayoutProviderOnboardingComponent extends BaseAsync implements OnIn
   readonly back = output<void>();
   /** Emitted just before handing off to the hosted-KYC page. */
   readonly started = output<void>();
+  /**
+   * Emitted when onboarding started but there is no hosted page to open
+   * (Wise email recipients: the account is linked and awaits the
+   * recipient's email confirmation). Consumers show a "linked, awaiting
+   * confirmation" state instead of navigating.
+   */
+  readonly pending = output<void>();
 
   private readonly payoutService = inject(PayoutService);
 
@@ -79,6 +87,10 @@ export class PayoutProviderOnboardingComponent extends BaseAsync implements OnIn
     this.run(
       this.payoutService.startOnboarding(),
       (res) => {
+        if (!res.url) {
+          this.pending.emit();
+          return;
+        }
         this.started.emit();
         // Same-tab handoff: window.open from an async callback is popup-blocked
         // (always on Safari), which used to leave users on a "waiting" screen

package/src/config.ts

@@ -53,9 +53,9 @@ export interface SailGuiConfig {
   appleServiceId?: string;
   /** Apple Sign-In redirect URI. Must match the Services ID configuration. */
   appleRedirectUri?: string;
-  /** Public URL of your privacy policy. Shown as a link in ConsentGateComponent. */
+  /** Public URL of your privacy policy. Linked from ConsentGateComponent and the login footer. */
   privacyPolicyUrl?: string;
-  /** Public URL of your terms of service. Shown in the SMS-consent disclosure. */
+  /** Public URL of your terms of service. Linked from the SMS-consent disclosure and the login footer. */
   termsUrl?: string;
   /** Brand name shown in the SMS/10DLC consent disclosure (e.g. "Daxoom"). */
   appName?: string;

package/src/index.ts

@@ -4,6 +4,7 @@ export * from './model/auth';
 export * from './model/common';
 export * from './model/dashboard';
 export * from './model/oauth_connection';
+export * from './model/agency';
 export * from './model/decorator';
 export * from './component/abstract/base_table';
 export * from './component/dashboard/dashboard_shell';
@@ -53,12 +54,20 @@ export * from './component/billing/seat_selector';
 export * from './component/billing/dunning_banner';
 export * from './component/payout/provider_onboarding';
 export * from './component/payout/bank_info_form';
+export * from './component/agency/agency_status_banner';
+export * from './component/agency/agency_clients';
+export * from './component/agency/agency_accept';
+export * from './component/agency/agency_earnings_summary';
+export * from './component/agency/commission_ledger';
+export * from './component/agency/agency_payout_history';
+export * from './component/agency/agency_payout_profile';
 export * from './component/payment/user_payment_methods';
 export * from './component/payment/sca_confirm';
 export * from './service/auth.service';
 export * from './service/sca_confirmer';
 export * from './service/billing.service';
 export * from './service/payout.service';
+export * from './service/agency.service';
 export * from './service/oauth_connection.service';
 export * from './service/user_payment_method.service';
 export * from './service/script_loader';

package/src/model/agency.ts

@@ -0,0 +1,109 @@
+export interface AgencyProfile {
+  agencyPartnerId: number;
+  wholesaleAllowed: boolean;
+  defaultCommissionRateBp?: number;
+  approvedAt?: string;
+  suspended: boolean;
+}
+
+export interface AgencyClientInput {
+  name: string;
+  email?: string;
+  website?: string;
+}
+
+export interface AgencyClient {
+  id: number;
+  name: string;
+  email?: string;
+  website?: string;
+  status: string;
+  clientPartnerId?: number;
+  acceptedBy?: number;
+  invitedAt?: string;
+  acceptedAt?: string;
+  expired?: boolean;
+  billingModel?: string;
+}
+
+export interface AgencyInvite {
+  invitationId: number;
+  agencyName: string;
+  clientName: string;
+  status: string;
+  expired?: boolean;
+}
+
+export interface AgencyDelegation {
+  id: number;
+  clientPartnerId: number;
+  clientName: string;
+  agencyPartnerId: number;
+  agencyName: string;
+  billingModel?: string;
+  grantedAt: string;
+}
+
+export interface AgencyEarningsBalance {
+  currency: string;
+  heldMinor: number;
+  dueMinor: number;
+  paidMinor: number;
+}
+
+export interface AgencyEarningEntry {
+  id: number;
+  clientName: string;
+  periodStart: string;
+  periodEnd: string;
+  amountMinor: number;
+  currency: string;
+  entryType: string;
+  status: string;
+  earnedAt: string;
+}
+
+export interface AgencyPayout {
+  id: number;
+  amountMinor: number;
+  currency: string;
+  status: string;
+  cutoffAt: string;
+  paidAt?: string;
+}
+
+export interface AgencyPayoutProfile {
+  agencyPartnerId: number;
+  userBankInfoId: number;
+  countryCode: string;
+  currency: string;
+  provider: string;
+  providerAccountId: string;
+  status: string;
+}
+
+export interface AgencyPayoutDestination {
+  userBankInfoId: number;
+  countryCode: string;
+  currency: string;
+  provider: string;
+  providerAccountId: string;
+}
+
+export interface AgencyPayoutProfileOptions {
+  profile: AgencyPayoutProfile | null;
+  destinations: AgencyPayoutDestination[];
+}
+
+export interface AgencyEarnings {
+  balances: AgencyEarningsBalance[];
+  entries: AgencyEarningEntry[];
+  payouts: AgencyPayout[];
+  payingClients: number;
+}
+
+export interface AgencyClientColumn {
+  id: string;
+  caption: string;
+  value: (client: AgencyClient) => string;
+}

package/src/model/appdata.ts

@@ -377,18 +377,22 @@ export interface ReusableAccount {
 	onboardedAt:       string;
 }
 
-// Result of PayoutService.startOnboarding(). url is opened in a webview /
-// external browser; the provider posts back via webhook when activation
-// lands.
+// Result of PayoutService.startOnboarding(). A non-empty url is opened in a
+// webview / external browser. Some providers have no hosted flow (for example,
+// Wise email recipients); in that case url and expiresAt are empty and
+// PayoutProviderOnboardingComponent emits `pending` while confirmation
+// continues asynchronously.
 export interface PayoutOnboardingSession {
 	url:               string;
 	externalAccountId: string;
 	expiresAt:         string;
 }
 
-// Payload the bank-info form emits. Maps 1:1 to basis user_bank_info
-// columns. The consumer decides where to POST it — typically a direct
-// generic-CRUD insert against /api/v1/user_bank_info.
+// Application-layer payload emitted by the bank-info form. It is not a
+// generic-CRUD row: taxId must be sealed into basis.user_bank_info's
+// tax_id_encrypted column. First-time setup goes through the consuming app's
+// registration service; changes use PayoutService.replaceBankInfo so keel can
+// atomically supersede the active destination version.
 export interface BankInfoFormValue {
 	countryCode:       string;
 	currency:          string;

package/src/service/agency.service.ts

@@ -0,0 +1,76 @@
+import { Injectable } from '@angular/core';
+import { Observable } from 'rxjs';
+import {
+  AgencyClient,
+  AgencyClientInput,
+  AgencyDelegation,
+  AgencyEarnings,
+  AgencyInvite,
+  AgencyPayoutProfileOptions,
+  AgencyProfile,
+} from '../model/agency';
+import { BaseRestService } from './base_rest.service';
+import { RestURL } from './rest_url';
+
+/** Thin REST client for keel/agency. */
+@Injectable({ providedIn: 'root' })
+export class AgencyService extends BaseRestService {
+  enroll(): Observable<{ message: string }> {
+    return this.http.post<{ message: string }>(this.url(RestURL.agencyEnrollURL), {});
+  }
+
+  profile(): Observable<{ profile: AgencyProfile | null }> {
+    return this.http.get<{ profile: AgencyProfile | null }>(this.url(RestURL.agencyProfileURL));
+  }
+
+  clients(): Observable<{ items: AgencyClient[]; activeClients: number }> {
+    return this.http.get<{ items: AgencyClient[]; activeClients: number }>(this.url(RestURL.agencyClientsURL));
+  }
+
+  addClients(clients: AgencyClientInput[]): Observable<{ added: number }> {
+    return this.http.post<{ added: number }>(this.url(RestURL.agencyClientsURL), { clients });
+  }
+
+  invite(invitationId: number): Observable<{ inviteLink: string }> {
+    return this.http.post<{ inviteLink: string }>(this.url(RestURL.agencyInviteClientURL), { invitationId });
+  }
+
+  cancel(invitationId: number): Observable<{ status: string }> {
+    return this.http.post<{ status: string }>(this.url(RestURL.agencyCancelClientURL), { invitationId });
+  }
+
+  setBillingModel(clientPartnerId: number, billingModel: 'R' | 'W'): Observable<{ billingModel: string }> {
+    return this.http.post<{ billingModel: string }>(this.url(RestURL.agencyBillingModelURL), {
+      clientPartnerId,
+      billingModel,
+    });
+  }
+
+  earnings(): Observable<AgencyEarnings> {
+    return this.http.get<AgencyEarnings>(this.url(RestURL.agencyEarningsURL));
+  }
+
+  payoutProfile(): Observable<AgencyPayoutProfileOptions> {
+    return this.http.get<AgencyPayoutProfileOptions>(this.url(RestURL.agencyPayoutProfileURL));
+  }
+
+  setPayoutProfile(userBankInfoId: number): Observable<{ status: string }> {
+    return this.http.post<{ status: string }>(this.url(RestURL.agencyPayoutProfileURL), { userBankInfoId });
+  }
+
+  inviteInfo(token: string): Observable<AgencyInvite> {
+    return this.http.get<AgencyInvite>(this.url(RestURL.agencyInviteInfoURL), { params: { token } });
+  }
+
+  accept(token: string): Observable<{ status: string }> {
+    return this.http.post<{ status: string }>(this.url(RestURL.agencyAcceptInviteURL), { token });
+  }
+
+  delegation(): Observable<{ delegation: AgencyDelegation | null }> {
+    return this.http.get<{ delegation: AgencyDelegation | null }>(this.url(RestURL.agencyDelegationURL));
+  }
+
+  revokeDelegation(clientPartnerId = 0): Observable<{ status: string }> {
+    return this.http.post<{ status: string }>(this.url(RestURL.agencyRevokeDelegationURL), { clientPartnerId });
+  }
+}

package/src/service/payout.service.ts

@@ -3,6 +3,7 @@ import { Observable } from 'rxjs';
 import { RestURL } from './rest_url';
 import { BaseRestService } from './base_rest.service';
 import {
+  BankInfoFormValue,
   PayoutOnboardingSession,
   ReusableAccount,
 } from '../model/appdata';
@@ -20,7 +21,11 @@ import {
  */
 @Injectable({ providedIn: 'root' })
 export class PayoutService extends BaseRestService {
-  /** Launch the hosted-KYC flow. Returns a URL to open + provider-side handle. */
+  /**
+   * Start provider onboarding. A non-empty URL is the hosted-KYC handoff;
+   * an empty URL means confirmation continues asynchronously (for example,
+   * a Wise recipient confirming from email).
+   */
   startOnboarding(): Observable<PayoutOnboardingSession> {
     return this.http.post<PayoutOnboardingSession>(this.url(RestURL.payoutOnboardStartURL), {});
   }
@@ -39,4 +44,25 @@ export class PayoutService extends BaseRestService {
   status(): Observable<{ complete: boolean }> {
     return this.http.post<{ complete: boolean }>(this.url(RestURL.payoutStatusURL), {});
   }
+
+  /**
+   * Replace the payout destination with a new bank-info version
+   * (atomic supersede + insert on the backend). Identity changes go
+   * through this, never through generic CRUD edits. `provider` and
+   * `providerAgreement` are server-owned and ignored here.
+   */
+  replaceBankInfo(value: BankInfoFormValue): Observable<{ message: string }> {
+    const { countryCode, currency, accountHolderName, billingAddress, taxIdType, taxId } = value;
+    return this.http.post<{ message: string }>(this.url(RestURL.payoutBankReplaceURL),
+      { countryCode, currency, accountHolderName, billingAddress, taxIdType, taxId });
+  }
+
+  /**
+   * Register a payout beneficiary from provider-collected details
+   * (Airwallex embedded beneficiary component). The payload passes
+   * through to the provider; the backend links the returned id.
+   */
+  registerBeneficiary(beneficiary: unknown): Observable<{ beneficiaryId: string }> {
+    return this.http.post<{ beneficiaryId: string }>(this.url(RestURL.payoutBeneficiaryURL), { beneficiary });
+  }
 }

package/src/service/rest_service.ts

@@ -11,6 +11,7 @@ export interface ProblemDetail {
     title?: string;
     detail?: string;
     status?: number;
+    code?: string;
     [key: string]: unknown;
 }
 

package/src/service/rest_url.ts

@@ -53,6 +53,22 @@ export const RestURL = {
   payoutReusableURL:     '/api/v1/payout/reusable',
   payoutReusableLinkURL: '/api/v1/payout/reusable/link',
   payoutStatusURL:       '/api/v1/payout/status',
+  payoutBankReplaceURL:  '/api/v1/payout/bank/replace',
+  payoutBeneficiaryURL:  '/api/v1/payout/beneficiary/register',
+  // Agency — keel/agency endpoints. The authenticated paths follow the same
+  // conventional /api/v1 mount as payout; inviteInfo is intentionally public.
+  agencyEnrollURL:           '/api/v1/agency/enroll',
+  agencyProfileURL:          '/api/v1/agency/profile',
+  agencyClientsURL:          '/api/v1/agency/clients',
+  agencyInviteClientURL:     '/api/v1/agency/clients/invite',
+  agencyCancelClientURL:     '/api/v1/agency/clients/cancel',
+  agencyBillingModelURL:     '/api/v1/agency/billing-model',
+  agencyEarningsURL:         '/api/v1/agency/earnings',
+  agencyPayoutProfileURL:    '/api/v1/agency/payout-profile',
+  agencyInviteInfoURL:       '/public/agency/invite',
+  agencyAcceptInviteURL:     '/api/v1/agency/invite/accept',
+  agencyDelegationURL:       '/api/v1/agency/delegation',
+  agencyRevokeDelegationURL: '/api/v1/agency/delegation/revoke',
   // User payment methods — list/delete go through keel's generic REST
   // CRUD against the UserSpecific basis table; set-default is a
   // TableAction (basis table_action row), mounted at the conventional