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 https://ge-exchange-staging-1.herokuapp.com/v1/api/members/{id}/token/{tokenId}/fund-invest

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

{
    "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
    }
}

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 · required

URL to redirect after payment completion

paymentMethod · string

Preferred payment method (e.g., card)

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

{
    "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
    }
}

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