Interface PayeeDirectory

The host's payee-verification directory (KYC or tax status). requestPayout consults it when configured: any state other than CLEARED rejects with PAYEE_UNVERIFIED before any credits are reserved, and a throwing directory faults the request — the gate fails closed. Optional in Ports; absent, every payee passes.

interface PayeeDirectory {
    status(
        userId: string,
        options?: CallOptions,
    ): Promise<PayeeVerification>;
}