SuperAPI AI Directory

flutterwave-verification

Coding & development

View repository

Updated 11-05 16:19

About this skill

flutterwave-verification

Purpose

Run account and identity checks before payment or payout actions.

Implementation Pattern (TypeScript)

const FLW_V3_BASE_URL = process.env.FLW_V3_BASE_URL ?? "https://api.flutterwave.com/v3";
const FLW_V4_BASE_URL = process.env.FLW_V4_BASE_URL ?? "https://developersandbox-api.flutterwave.com";
const FLW_SECRET_KEY = process.env.FLW_SECRET_KEY;

type FlwResponse<T> = {
  status: "success" | "error";
  message: string;
  data: T;
};

class FlutterwaveApiError extends Error { constructor( message: string, public readonly statusCode: number, public readonly payload?: unknown, ) { super(message); this.name = "FlutterwaveApiError"; } }

function getBaseUrl(version: "v3" | "v4") { return version === "v3" ? FLW_V3_BASE_URL : FLW_V4_BASE_URL; }

async function flwRequest( version: "v3" | "v4", path: string, init: RequestInit = {}, ): Promise<FlwResponse> { if (!FLW_SECRET_KEY) { throw new Error("Missing FLW_SECRET_KEY"); }

const response = await fetch(${getBaseUrl(version)}${path}, { ...init, headers: { "Content-Type": "application/json", Authorization: Bearer ${FLW_SECRET_KEY}, ...(init.headers ?? {}), }, });

const body = (await response.json()) as FlwResponse;

if (!response.ok || body.status === "error") { throw new FlutterwaveApiError( body.message || "Flutterwave API request failed", response.status, body, ); }

return body; }


## Endpoint Operations and References

| Version | Method | Route / Operation | Use Case | Reference |
| --- | --- | --- | --- | --- |
| v3 | GET | /accounts/resolve | Resolve bank account | https://developer.flutterwave.com/docs/getting-started |
| v4 | POST | /bank-account-resolve | Resolve bank account details | https://developer.flutterwave.com/reference/bank_account_resolve_post |
| v4 | POST | /wallet-account-resolve | Resolve wallet account | https://developer.flutterwave.com/reference/wallet_account_resolve_post |
| v4 | GET | /banks | Retrieve bank list | https://developer.flutterwave.com/reference/banks_get |

## Country / Rail Matrix

| Market | Rail | Integration Notes |
| --- | --- | --- |
| NG | Account resolution | Mandatory before payouts. |
| KE/GH | Wallet lookup | Useful for MoMo beneficiary validation. |
| All | Pre-flight checks | Reduce payment and transfer failure rates. |

## Usage Example

```ts
export async function runVerificationExample() {
  return flwRequest<unknown>("v4", "/bank-account-resolve", {
    method: "GET",
  });
}

Reliability Checklist

  • Re-verify successful payment state server-side before fulfillment.
  • Store provider ids, internal ids, tx_ref, and event ids for reconciliation.
  • Keep webhook consumers idempotent and return HTTP 200 quickly.
  • Separate version-specific request/response types to avoid schema mixups.

v4 Delta Note

v4 is resource-centric in the public reference. Keep route maps and payload types versioned in code so agent-generated integrations remain accurate.