Getting Started

Before integrating with LedgerBlock, complete the setup steps below in the specified order. This process establishes your merchant account, obtains approval, configures users and wallets, completes KYC verification, and prepares your integration to securely access LedgerBlock services.

Legerblock Base_Url: https://block.fuspay.finance

Integration Flow

Create Merchant → Send x-merchant-ref for Approval → Create User → Create Wallets (NGN, USDT) → Map KYC Billing Wallet → Perform User KYC and Verify KYC → Whitelist IP → Set Up Webhook Validation → Wallet PIN Setup → Consume API Services

StepSetupWhy it is neededWhat to do
1Create MerchantEstablishes your merchant account and generates the credentials required for integration.Visit the merchant onboarding page to Complete merchant onboarding and obtain your API Key, x-merchant-ref, Merchant Default Wallet, and other required merchant details.
2Send x-merchant-ref for ApprovalEnsures your merchant account is approved before proceeding with operations that require merchant approval.Submit your x-merchant-ref for approval and wait for confirmation before continuing.
3Create UserRegisters a user under your merchant account so they can access supported LedgerBlock services.Use the Create User endpoint to register the user and obtain their user_ref.
4Create Wallets (NGN, USDT)Provides the user with the required fiat and cryptocurrency wallets.Create the user's NGN and USDT wallets and retain the returned wallet identifiers.
5Map KYC Billing WalletDesignates the wallet used to pay applicable KYC verification fees.Use the KYC billing wallet endpoint to associate the appropriate wallet with the user.
6Perform User KYC and Verify KYCVerifies the user's identity and determines eligibility for services that require identity verification.Submit the required KYC information, initiate verification, and confirm the user's KYC status.
7Whitelist IPIP whitelisting is mandatory before a user can initiate or process payouts. It restricts payout operations to approved IP addresses.Submit the public IP address(es) your application will use to access LedgerBlock and have them whitelisted.
8Set Up Webhook ValidationEnables your system to receive event notifications and verify their authenticity.Configure your webhook endpoint and validate incoming webhook signatures using HMAC-SHA512 and the x-ledgerblock-signature header.
9Wallet PIN SetupEstablishes the wallet PIN required for supported operations that require PIN authorization.Use the appropriate wallet PIN setup endpoint to create the user's wallet PIN before initiating operations that require it.
10Consume API ServicesEnables your application to access the LedgerBlock services available to your merchant and users.Configure requests with the required credentials and headers, then integrate the relevant services according to their individual requirements.

Important: Complete the prerequisite steps in order. Service availability may depend on merchant approval, wallet configuration, KYC status, and the specific authorization requirements of each endpoint.


Did this page help you?