Fund with Cards

Top-up for payouts using cards.

Charge Card

POST https://staging.moneywaveapp.com/v1/transfer/rave

This endpoint enables funding using cards.

Headers

Name	Type	Description
Authentication	string	Authentication Token

Request Body

Name	Type	Description
firstname	string	Payers first name
lastname	string	Payers last name
phonenumber	string	Payers phone number
email	string	Payers email address
card_no	string	Card Number
cvv	string	Card CVV
expiry_year	string	Card Expiry Year : ie 20
expiry_month	string	Card Expiry Month : ie 03
pin	string	Card Pin
redirecturl	string	Your Redirect Url
medium	string	Medium of transaction : ie web, mobile, etc
recipient	string	Recipient type : ie wallet
recipient_id	string	Specified recipient : ie wallet user reference

200 Successful Response

{
    "status": "success",
    "data": {
        "transfer": {
            "id": 21122,
            "type": "fund-wallet",
            "firstName": "Okoi",
            "lastName": "Ibiang",
            "phoneNumber": "[phone]",
            "recipientPhone": null,
            "status": "started",
            "system_status": null,
            "medium": "mobile",
            "ip": "::ffff:127.0.0.1",
            "exchangeRate": null,
            "amountToSend": 1000,
            "amountToCharge": 1030,
            "disburseCurrency": "NGN",
            "chargeCurrency": "NGN",
            "flutterChargeResponseCode": "02",
            "flutterChargeResponseMessage": "Please enter the OTP sent to your mobile number 080****** and email te**@rave**.com",
            "flutterDisburseResponseMessage": null,
            "flutterChargeReference": "FLW-MOCK-fcbeae90aeb66a67d54b6c9c80665a6a",
            "flutterDisburseReference": null,
            "flutterDisburseResponseCode": null,
            "merchantCommission": 30,
            "moneywaveCommission": 0,
            "netDebitAmount": 1030,
            "chargedFee": 30,
            "receiptNumber": null,
            "redirectUrl": "http://www.bts.com.ng",
            "linkingReference": null,
            "source": "card",
            "source_id": 982,
            "meta": {},
            "additionalFields": null,
            "ref": "029716510712",
            "r1": 1,
            "r2": 1,
            "createdAt": "2020-02-27T11:29:32.000Z",
            "updatedAt": "2020-02-27T11:29:43.000Z",
            "deletedAt": null,
            "userId": 107,
            "merchantId": 1,
            "beneficiaryId": 1,
            "accountId": null,
            "cardId": 982,
            "account": null
        },
        "cycle": "one-time",
        "authurl": "https://ravesandboxapi.flutterwave.com/mockvbvpage?ref=FLW-MOCK-fcbeae90aeb66a67d54b6c9c80665a6a&code=00&message=Approved. Successful&receiptno=RN1582802990424",
        "authModelUsed": "ACCESS_OTP",
        "responseMessage": "Please enter the OTP sent to your mobile number 080****** and email te**@rave**.com",
        "pendingValidation": true,
        "chargeMethod": "VBVSECURECODE"
    }
}

Charge responses with chargeMethod set to VBVSECURECODE are to redirect to the returned authurl. Other methods can be completed using the verify charge api below.

Verify Charge Card

POST https://staging.moneywaveapp.com/v1/transfer/rave/otp

This endpoint enables completion of OTP type transactions and not required for direct charge transactions using tokens. For such transactions payment is completed on charge card request. See charge verification below.

Headers

Name	Type	Description
Authorization	string

Request Body

Name	Type	Description
transaction_reference	string	Charge transaction reference
otp	string	One time token required to complete charge.

200

Charge Verification requires the following process: when a card is charged you need to check the flutterChargeResponseCode. If this value is 00, this indicates a charge success and further verification is not required. If the value is 02, this indicates a pending validation and you should check the chargeMethod and take the following steps: VBV - redirect to authurl OTP - verify using the OTP sent