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
| Step | Setup | Why it is needed | What to do |
|---|---|---|---|
| 1 | Create Merchant | Establishes 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. |
| 2 | Send x-merchant-ref for Approval | Ensures 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. |
| 3 | Create User | Registers 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. |
| 4 | Create 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. |
| 5 | Map KYC Billing Wallet | Designates the wallet used to pay applicable KYC verification fees. | Use the KYC billing wallet endpoint to associate the appropriate wallet with the user. |
| 6 | Perform User KYC and Verify KYC | Verifies 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. |
| 7 | Whitelist IP | IP 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. |
| 8 | Set Up Webhook Validation | Enables 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. |
| 9 | Wallet PIN Setup | Establishes 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. |
| 10 | Consume API Services | Enables 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.
Updated 18 days ago
