Fund and Invest

Initiates a fund-and-invest transaction for a member. This creates a payment link that the member can use to fund their wallet and invest in a token in a single flow.

POST api/members/{id}/token/{tokenId}/fund-invest

Card Payment

{
    "investmentAmount": 100000,
    "currency": "NGN",
    "redirectUrl": "https://app.getequity.io/callback",
    "paymentMethod": "card"
}

{
    "investmentAmount": 100000,
    "currency": "NGN",
    "paymentMethod": "bank_transfer"
}

Card Payment

{
    "status": "success",
    "message": "Payment initiated successfully. Complete payment to invest.",
    "data": {
        "paymentLink": "https://checkout-v2.dev-flutterwave.com/v3/hosted/pay/550b3feb5a259d265c29",
        "reference": "GETXN_FI_LW6PEBET78XW72",
        "investmentAmount": 100000,
        "currency": "NGN",
        "token": {
            "_id": "682b2f367732900002613bfc",
            "symbol": "OPAS2",
            "name": "Ojaja Pan African LTD Series 2 Commercial Paper",
            "price": 10000
        },
        "tokensToCredit": 10,
        "fees": {
            "getequity": 2000,
            "getequityPercent": 2,
            "flutterwave": 1428,
            "total": 3428
        },
        "totalCharge": 103428
    }
}

{
    "status": "success",
    "message": "Payment initiated successfully. Complete payment to invest.",
    "data": {
        "paymentMethod": "bank_transfer",
        "reference": "GETXN_FI_SJ74KB44TGXUAB",
        "virtualAccount": {
            "bankName": "Wema Bank",
            "accountNumber": "TRP1420081"
        },
        "amountToPay": 103428,
        "investmentAmount": 100000,
        "currency": "NGN",
        "token": {
            "_id": "683ef69f70457700022e091b",
            "symbol": "FDNE",
            "name": "FCMB Debt Note",
            "price": 10000
        },
        "tokensToCredit": 10,
        "fees": {
            "getequity": 2000,
            "getequityPercent": 2,
            "flutterwave": 1428,
            "total": 3428
        },
        "totalCharge": 103428
    }
}

id · string · required

The member’s user ID

tokenId · string · required

The token ID to invest in

investmentAmount · number · required

The amount to invest

currency · string · required

The currency code (e.g., NGN, USD)

redirectUrl · string

URL to redirect after payment completion. Required when paymentMethod is card. Not needed for bank_transfer.

paymentMethod · string

Preferred payment method. Supported values: card, bank_transfer. When bank_transfer is used, virtual account details are returned instead of a payment link.

Card Payment

{
    "investmentAmount": 100000,
    "currency": "NGN",
    "redirectUrl": "https://app.getequity.io/callback",
    "paymentMethod": "card"
}

{
    "investmentAmount": 100000,
    "currency": "NGN",
    "paymentMethod": "bank_transfer"
}

Card Payment

{
    "status": "success",
    "message": "Payment initiated successfully. Complete payment to invest.",
    "data": {
        "paymentLink": "https://checkout-v2.dev-flutterwave.com/v3/hosted/pay/550b3feb5a259d265c29",
        "reference": "GETXN_FI_LW6PEBET78XW72",
        "investmentAmount": 100000,
        "currency": "NGN",
        "token": {
            "_id": "682b2f367732900002613bfc",
            "symbol": "OPAS2",
            "name": "Ojaja Pan African LTD Series 2 Commercial Paper",
            "price": 10000
        },
        "tokensToCredit": 10,
        "fees": {
            "getequity": 2000,
            "getequityPercent": 2,
            "flutterwave": 1428,
            "total": 3428
        },
        "totalCharge": 103428
    }
}

{
    "status": "success",
    "message": "Payment initiated successfully. Complete payment to invest.",
    "data": {
        "paymentMethod": "bank_transfer",
        "reference": "GETXN_FI_SJ74KB44TGXUAB",
        "virtualAccount": {
            "bankName": "Wema Bank",
            "accountNumber": "TRP1420081"
        },
        "amountToPay": 103428,
        "investmentAmount": 100000,
        "currency": "NGN",
        "token": {
            "_id": "683ef69f70457700022e091b",
            "symbol": "FDNE",
            "name": "FCMB Debt Note",
            "price": 10000
        },
        "tokensToCredit": 10,
        "fees": {
            "getequity": 2000,
            "getequityPercent": 2,
            "flutterwave": 1428,
            "total": 3428
        },
        "totalCharge": 103428
    }
}

Error Codes

Code	HTTP Status	Description
TOKEN_ACCESS_DENIED_ERROR	403	User doesn’t have access to this token
DEAL_ACCESS_DENIED_ERROR	403	User doesn’t have access to this deal
TOKEN_CLOSED_ERROR	400	Token is closed for investment
TOKEN_EXITED_ERROR	400	Token has exited
AMOUNT_TOO_LOW_ERROR	400	Investment amount is below minimum
BELOW_MIN_TRADE_ERROR	400	Amount below minimum trade limit
ABOVE_MAX_TRADE_ERROR	400	Amount above maximum trade limit
INVALID_AMOUNT_ERROR	400	Invalid investment amount
PAYMENT_INITIATION_ERROR	502	Failed to initiate payment with provider
TOKEN_NOT_FOUND_ERROR	404	Token not found