Static Accounts NGN

This helps to map a static account to an NGN wallet for easy funding

Assigns a fund source to a user's subwallet. This endpoint links a specific funding configuration, such as a static crypto address, to the user's wallet using the provided wallet, chain, currency, and account reference. User KYC information can also be provided as part of the fund source configuration.

Request

Method: POST

Endpoint:

{{base_url}}/api/v1/user/subwallet-fund-source

Headers

HeaderTypeRequiredDescription
x-merchant-refStringYesYour unique merchant reference.

This endpoint does not require an Authorization header.

Request Body

{
	"user_ref": "UREFB57BE10C22F04348B429E20E8D62DB7A003F7",
	"wallet_id": "LBWNGNE2EC9DE6B9924C27B756282B7FCDD60C00BS4",
	"fund_type": "STATIC_VIRTUAL_ACCOUNT",
	"chain": "FIAT_ACCOUNT",
	"currency": "NGN",
	"account_reference": "Rava_001_1",
	"user_kyc": {
		"name": "Tes Ayan",
		"email": "[email protected]",
		"address": "Lagos, Nigeria",
		"phone": "2348779",
		"bvn": "22145",
		"dob": "1980-09-23"
	}
}

Request Fields

FieldTypeRequiredDescription
user_refStringYesUnique reference of the user whose wallet the fund source will be assigned to.
wallet_idStringYesUnique identifier of the user's subwallet.
fund_typeStringYesType of fund source being assigned.
chainStringYesBlockchain or network associated with the fund source.
currencyStringYesCurrency supported by the fund source.
account_referenceStringYesReference identifying the funding account.
user_kycObjectYesKYC information associated with the fund source.
user_kyc.nameStringYesUser's full name.
user_kyc.emailStringYesUser's email address.
user_kyc.addressStringYesUser's residential address.
user_kyc.phoneStringYesUser's phone number.
user_kyc.bvnStringYesUser's Bank Verification Number.
user_kyc.dobStringYesUser's date of birth.

Response

Success Response

{
  "status": "success",
  "message": "Assigned successfully",
  "fiat_data": {
    "funding_source_id": "88202acf-0894-430f-9902-4dc791558262",
    "account_number": "6011440410",
    "bank_code": "SAFE HAVEN MFB",
    "currency": "NGN"
  },
  "crypto_data": {
    "funding_source_id": "",
    "address": "",
    "chain": ""
  }
}

Did this page help you?