Assign funding sources

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 Authorization header.

Request Body

{
  "user_ref": "{{vault:Merchant-user-ref}}",
  "wallet_id": "LBWEUSD:MOB677851297ADB454BB35E1EEE16214E9B00EJU",
  "fund_type": "STATIC_CRYPTO_ADDRESS",
  "chain": "MOB",
  "currency": "EUSD",
  "account_reference": "SEUSD0000012301-500-93",
  "user_kyc": {
    "name": "Teslim Ayantola",
    "email": "[email protected]",
    "address": "No 6 sars road",
    "phone": "2348064642044",
    "bvn": "22300671781",
    "dob": "1987-05-03"
  }
}

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

{
  "user_ref": "{{vault:Merchant-user-ref}}",
  "wallet_id": "LBWEUSD:MOB677851297ADB454BB35E1EEE16214E9B00EJU",
  "fund_type": "STATIC_CRYPTO_ADDRESS",
  "chain": "MOB",
  "currency": "EUSD",
  "account_reference": "SEUSD0000012301-500-93",
  "user_kyc": {
    "name": "Teslim Ayantola",
    "email": "[email protected]",
    "address": "No 6 sars road",
    "phone": "2348064642044",
    "bvn": "22300671781",
    "dob": "1987-05-03"
  }
}

Response Fields

Field	Type	Description
`user_ref`	String	Unique reference of the user associated with the fund source.
`wallet_id`	String	Unique identifier of the wallet to which the fund source was assigned.
`fund_type`	String	Type of fund source assigned to the wallet.
`chain`	String	Blockchain or network associated with the fund source.
`currency`	String	Currency supported by the fund source.
`account_reference`	String	Reference identifying the funding account.
`user_kyc`	Object	KYC information associated with the fund source.
`user_kyc.name`	String	User's full name.
`user_kyc.email`	String	User's email address.
`user_kyc.address`	String	User's residential address.
`user_kyc.phone`	String	User's phone number.
`user_kyc.bvn`	String	User's Bank Verification Number.
`user_kyc.dob`	String	User's date of birth.