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
| Header | Type | Required | Description |
|---|---|---|---|
x-merchant-ref | String | Yes | Your unique merchant reference. |
This endpoint does not require an
Authorizationheader.
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
| Field | Type | Required | Description |
|---|---|---|---|
user_ref | String | Yes | Unique reference of the user whose wallet the fund source will be assigned to. |
wallet_id | String | Yes | Unique identifier of the user's subwallet. |
fund_type | String | Yes | Type of fund source being assigned. |
chain | String | Yes | Blockchain or network associated with the fund source. |
currency | String | Yes | Currency supported by the fund source. |
account_reference | String | Yes | Reference identifying the funding account. |
user_kyc | Object | Yes | KYC information associated with the fund source. |
user_kyc.name | String | Yes | User's full name. |
user_kyc.email | String | Yes | User's email address. |
user_kyc.address | String | Yes | User's residential address. |
user_kyc.phone | String | Yes | User's phone number. |
user_kyc.bvn | String | Yes | User's Bank Verification Number. |
user_kyc.dob | String | Yes | User'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": ""
}
}Updated 11 days ago
Did this page help you?
