feat: add identity and business verification trigger

.circleci/config.yml

@@ -1,7 +1,7 @@
 version: 2.1
 
 orbs:
-  codecov: codecov/codecov@5.0.3
+  codecov: codecov/codecov@6.0.0
 
 executors:
   default:

lib/VerificationGateway.ts

@@ -38,6 +38,11 @@ export class VerificationGateway {
     return new PaginatedArray<types.Verification.Verification>(result.meta, ...result.verifications);
   }
 
+  async triggerIdentityOrBusinessVerification(body: types.Verification.TriggerIdentityOrBusinessRequest) {
+    const endPoint = buildURL("verifications", "trigger");
+    return this.gateway.client.post<types.Verification.TriggerIdentityOrBusinessResult>(endPoint, body);
+  }
+
   async triggerWatchlist(body: any) {
     const endPoint = buildURL("verifications", "watchlist", "trigger");
     const result = await this.gateway.client.post<types.Verification.ListResult>(endPoint, body);

lib/types.ts

@@ -88,6 +88,30 @@ export namespace Balance {
 }
 
 export namespace Verification {
+  export type IdentityOrBusinessType = "individual" | "business";
+  export type RetryRejectedReasonType = "unprocessable" | "invalid" | "missing_requirements" | "fraudulent";
+
+  export interface TriggerIdentityOrBusinessRequest {
+    recipientId: string;
+    types: IdentityOrBusinessType[];
+    enforceInactiveUntilVerified?: boolean;
+    retryAllowed?: boolean;
+    retryRejectedReasonTypes?: RetryRejectedReasonType[];
+  }
+
+  export interface TriggerIdentityOrBusinessVerification {
+    type: IdentityOrBusinessType;
+    status: "created" | "failed";
+    verificationId?: string;
+    error?: string;
+  }
+
+  export interface TriggerIdentityOrBusinessResult {
+    ok: boolean;
+    recipientId: string;
+    verifications: TriggerIdentityOrBusinessVerification[];
+  }
+
   export interface Verification {
     id: string;
     type: string;

test/unit/releasePrepSpec.ts

@@ -95,13 +95,29 @@ describe("Release prep endpoint coverage", () => {
     assert.strictEqual((await verifications.trigger("individual", { recipientIds: ["R-123"] }))[0].id, "WV-123");
     assert.strictEqual((await verifications.triggerWatchlist({ recipientIds: ["R-123"] }))[0].id, "WV-123");
     assert.strictEqual((await verifications.trigger_watchlist({ recipientIds: ["R-123"] }))[0].id, "WV-123");
+    const identityResponse = {
+      ok: true,
+      recipientId: "R-123",
+      verifications: [{ type: "individual", status: "created", verificationId: "IV-123" }],
+    };
+    client.post.resolves(identityResponse);
+    assert.deepStrictEqual(await verifications.triggerIdentityOrBusinessVerification({
+      recipientId: "R-123",
+      types: ["individual"],
+      retryAllowed: true,
+    }), identityResponse);
 
     assert.deepStrictEqual(client.get.getCall(0).args, ["/v1/verifications?verificationType=watchlist&page=1&pageSize=10"]);
     assert.deepStrictEqual(client.get.getCall(1).args, ["/v1/verifications?page=1"]);
     assert.deepStrictEqual(client.patch.getCall(0).args, ["/v1/verifications/expire", { type: "individual", verificationIds: ["IV-123"] }]);
     assert.deepStrictEqual(client.post.getCall(0).args, ["/v1/verifications/individual/trigger", { recipientIds: ["R-123"] }]);
     assert.deepStrictEqual(client.post.getCall(1).args, ["/v1/verifications/watchlist/trigger", { recipientIds: ["R-123"] }]);
     assert.deepStrictEqual(client.post.getCall(2).args, ["/v1/verifications/watchlist/trigger", { recipientIds: ["R-123"] }]);
+    assert.deepStrictEqual(client.post.getCall(3).args, ["/v1/verifications/trigger", {
+      recipientId: "R-123",
+      types: ["individual"],
+      retryAllowed: true,
+    }]);
   });
 
   it("constructs gateway verification aliases", () => {