RAVE JAVA 🍻

---

Services implemented are:

• Card payment
• Mobile money
• Payment Validation
• Virtual cards
• QR payments
• Bills
• Ebills
• BVN Validation
• Refunds
• Tokenized Charge
• PaymentPlan
• Subscriptions
• Bank payments
• Split Payments
• Transfers
• Subaccount Management

---

How to install:

There are two ways to install this.

METHOD 1:

Download RAVE-JAVA Download and add jar file as a Module to your Java project:

Download from https://github.com/cleopatra27/rave-java/releases/latest

On Intellij IDEA: File -> Project Structure -> Modules -> Dependencies Tab -> Add -> JARs or Directories -> Attach jar

On Netbeans: Project properties -> Libraries -> Compile -> ADD JAR/folder -> Add Jar

METHOD 2:

Maven users

Add this dependency to your project's POM:

<dependency>
 <groupId>com.flutterwave</groupId>
    <artifactId>Rave-Java</artifactId>
    <version>1.04</version>
</dependency>

Gradle users

Add this dependency to your project's build file:

compile("com.flutterwave:Rave-Java:1.04")

---

Usage:

Direct Charge

cardPayment cardPayment = new cardPayment();
cardLoad cardload = new cardLoad cardload();
cardload.setPublic_key(PBFPubKey);
cardload.setCardno(cardno);
cardload.setCvv(cvv);
cardload.setExpirymonth(expirymonth);
cardload.setCurrency(currency);
cardload.setCountry(country);
cardload.setAmount(amount);
cardload.setEmail(email);
cardload.setPhonenumber(phonenumber);
cardload.setfirstname(firstname);
cardload.setLastname(lastname);
cardload.setMetaname(metaname);
cardload.setMetaValue(metavalue);
cardload.setExpiryyear(exp_year);
cardload.setRedirect_url(redirect_url);
cardload.setDevice_fingerprint(device_fingerprint);
cardload.setEncryption_key(encryption_key);
//if split payment set subaccount values
//set charge_type to "preauth" if preauth
  
String response = cardPayment.doflwcardpayment(cardload);

JSONObject myObject = new JSONObject(response);

if(myObject.optString("suggested_auth").equals("PIN"))
{
  //get PIN fom customer
  cardload.setPin(PIN);
  cardload.setSuggested_auth("PIN");
  String response_one = cardPayment.doflwcardpayment(cardload);
  
JSONObject iObject = new JSONObject(response_one);
JSONObject Object = iObject.optJSONObject("data");
  
String transaction_reference = Object.optString("flwRef");
  
validateCardCharge validatecardcharge = new validateCardCharge();
validateCardPayload validatecardpayload = new validateCardPayload();
validatecardpayload.setPBFPubKey(PBFPubKey);
validatecardpayload.setTransaction_reference(transaction_reference);
validatecardpayload.setOtp(OTP);
  
response = validatecardcharge.doflwcardvalidate(validatecardpayload);
}
else if(myObject.optString("suggested_auth").equals("NOAUTH_INTERNATIONAL"))
{
  //billing info - billingzip, billingcity, billingaddress, billingstate, billingcountry
  cardload.setBillingaddress(Billingaddress);
  cardload.setBillingcity(Billingcity);
  cardload.setBillingcountry(Billingcountry);
  cardload.setBillingstate(Billingstate);
  cardload.setBillingzip(Billingzip);
  cardload.setSuggested_auth("NOAUTH_INTERNATIONAL");
  String response_one = cardPayment.doflwcardpayment(cardload);
  
JSONObject iObject = new JSONObject(response_one);
JSONObject Object = iObject.optJSONObject("data");
  
String transaction_reference = Object.optString("flwRef")
  
validateCardCharge validatecardcharge = new validateCardCharge();
validateCardPayload validatecardpayload = new validateCardPayload();
validatecardpayload.setPBFPubKey(PBFPubKey);
validatecardpayload.setTransaction_reference(transaction_reference);
  
response = validatecardcharge.doflwcardvalidate(validatecardpayload);
}
else if(myObject.optString("authurl")!="N/A")
{
  //load the url in an IFRAME
}

return response;

Mobile Money

mobileMoney mobileMoney = new mobileMoney();
mobilemoneyPayload mobilemoneyPayload = new mobilemoneyPayload();
mobilemoneyPayload.setPBFPubKey(PBFPubKey);
mobilemoneyPayload.setCurrency(currency);
mobilemoneyPayload.setAmount(amount);
mobilemoneyPayload.setPhonenumber(phonenumber);
mobilemoneyPayload.setEmail(email);
mobilemoneyPayload.setFirstname(firstname);
mobilemoneyPayload.setLastname(lastname);
mobilemoneyPayload.setNetwork(narration);
mobilemoneyPayload.setMetaname(metaname);
mobilemoneyPayload.setCountry(country);
mobilemoneyPayload.setMetavalue(metavalue);
mobilemoneyPayload.setDevice_fingerprint(device_fingerprint);
mobilemoneyPayload.setPayment_type(Payment_type);
mobilemoneyPayload.setEncryption_key(encryption_key);
mobilemoneyPayload.setPublic_key(pub_key);
//if split payment set subaccount values

String response = mobileMoney.domobilemoney(mobilemoneyPayload);

return response; 

Transfers(African Banks)

transfers transfers = new transfers();
transferPayload transferPayload = new transferPayload();
transferPayload.setAccount_bank(account_bank);
transferPayload.setAccount_number(account_number);
transferPayload.setAmount(amount);
transferPayload.setSeckey(seckey);
transferPayload.setNarration(narration);
transferPayload.setCurrency(currency);
transferPayload.setReference(reference);
transferPayload.setBeneficiary_name(beneficiary_name);
transferPayload.setDestination_branch_code(destination_branch_code);

String response = transfers.dotransfer(transferPayload);

Transfers

transfers transfers = new transfers();
transferPayload transferPayload = new transferPayload();
transferPayload.setAccount_bank(account_bank);
transferPayload.setAccount_number(account_number);
transferPayload.setAmount(amount);
transferPayload.setSeckey(seckey);
transferPayload.setNarration(narration);
transferPayload.setCurrency(currency);
transferPayload.setReference(reference);
transferPayload.setBeneficiary_name(beneficiary_name);
transferPayload.setDestination_branch_code(destination_branch_code);

List<metaTransferpayload> list = new ArrayList<>();

//please change forloop to suit your need
for (int i = 0; i <=0; i++) {
metaTransferpayload metaTransferpayload = new metaTransferpayload();
metaTransferpayload.setAccountNumber(AccountNumber);
metaTransferpayload.setRoutingNumber(RoutingNumber);
metaTransferpayload.setSwiftCode(SwiftCode);
metaTransferpayload.setBankName(BankName);
metaTransferpayload.setBeneficiaryName(BeneficiaryName);
metaTransferpayload.setBeneficiaryAddress(BeneficiaryAddress);
metaTransferpayload.setBeneficiaryCountry(BeneficiaryCountry);

list.add(metaTransferpayload);
}

//add metaTransferpayload to transferPayload
transferPayload.setMeta(list);

String response = transfers.dotransfer(transferPayload);

Bulk Transfer

transfers transfers = new transfers();
bulkPayload bulkPayload = new bulkPayload();
List<bulkdataPayload> list = new ArrayList<>();
bulkPayload.setSeckey(seckey);
bulkPayload.setTitle(title);

//please change forloop to suit your need
for (int i = 0; i <=0; i++) {
bulkdataPayload bulkdataPayload = new bulkdataPayload();
bulkdataPayload.setBank(Bank);
bulkdataPayload.setAccount_number(Account_number);
bulkdataPayload.setAmount(Amount);
bulkdataPayload.setCurrency(Currency);
bulkdataPayload.setNarration(Narration);
bulkdataPayload.setReference(reference);

list.add(bulkdataPayload);
}

//add bulkdataPayload to bulkPayload
bulkPayload.setBulk_data(list);

String response = transfers.dobulktransfer(bulkPayload);

Retrive Bulk Transfer Status

transfers transfers = new transfers();
String response = transfers.doRetriveBulkStatus(seckey, batch_id);

Retrive Single Transfer Status

transfers transfers = new transfers();
String response = transfers.doRetriveSingleStatus(seckey, ref);

Account Resolve

AccountResolvePayload AccountResolvePayload = new AccountResolvePayload();

AccountResolvePayload.setCountry(country);
AccountResolvePayload.setCurrency(currency);
AccountResolvePayload.setDestbankcode(code);
AccountResolvePayload.setPBFPubKeypublickey);
AccountResolvePayload.setRecipientaccount(account);
        
String response = new AccountResolve().doAccountResolve(AccountResolvePayload);

Get BankList

transfers transfers = new transfers();
String response = transfers.doGetBankList(country, publickey);

QR code

qrPayments qrPayments = new qrPayments();
qrcodePayload qrcodepayload = new qrcodePayload();
qrcodepayload.setPBFPubKey(PBFPubKey);
qrcodepayload.setAmount(amount);
qrcodepayload.setTxref(teRef);
qrcodepayload.setPayment_Type(payment_type);
qrcodepayload.setDevice_fingerprint(Device_fingerprint);
qrcodepayload.setMetaname(metaname);
qrcodepayload.setMetavalue(metavalue);
qrcodepayload.setEmail(email);
qrcodepayload.setPublic_key(pub_key);

String response = qrPayments.doflwqrpayment(qrcodepayload);

Bills

bills bills = new bills();
BillModel billmodel = new BillModel();
billmodel.setCustomerId(CustomerId);
billmodel.setReference(Reference);
billmodel.setAmount(amount);
billmodel.setIsAirtime(IsAirtime);
billmodel.setBillername(billername);
billmodel.setSecretkey(sevretkey);

bills.dobillpayment(billmodel);

BVN Validation

bvnValidation bvnvalidation = new bvnValidation();
bvnload bvnload = new bvnload();
bvnload.setBvn(bvn)

String response = bvnvalidation(bvnload);

Payment Plans

paymentplan paymentplan = new paymentplan();
pamentplancreatepayload pamentplancreatepayload = new pamentplancreatepayload();
pamentplancreatepayload.setAmount(amount);
pamentplancreatepayload.setName(name);
pamentplancreatepayload.setIntervale(interval);
pamentplancreatepayload.setDuration(duration);
pamentplancreatepayload.setRef(ref);

String response = paymentplan.docreatepayment(pamentplancreatepayload);

return response;

Virtual Cards

Sample Code to create a virtual card.

virtualCards virtualCards = new virtualCards();
virtualcardpayload virtualcardpayload = new virtualcardpayload():
virtualcardpayload.setCurrency(currency);
virtualcardpayload.setAmount(amount);
virtualcardpayload.setBilling_name(billing_name);
virtualcardpayload.setBilling_address(billing_Address);
virtualcardpayload.setBilling_city(billing_city);
virtualcardpayload.setBilling_state(billing_state);
virtualcardpayload.setBilling_postal_code(billing_postal_code);
virtualcardpayload.setSecret_Key(secret_key);

String response = virtualCards.dovirtualcardcreate(virtualcardpayload);

Sample Code to get for a virtual card.

virtualCards virtualCards = new virtualCards();
virtualcardpayload virtualcardpayload = new virtualcardpayload():
virtualcardpayload.setId(id);
virtualcardpayload.setSecret_Key(secret_key);
virtualcardpayload.setTest(test);

String response = virtualCards.dovirtualcardsearch(virtualcardpayload);

Sample Code to List virtual cards.

virtualCards virtualCards = new virtualCards();
virtualcardpayload virtualcardpayload = new virtualcardpayload():
virtualcardpayload.setPage(page);
virtualcardpayload.setSecret_Key(secret_key);

String response = virtualCards.dovirtualcardget(virtualcardpayload);

Sample Code to terminate a virtual card.

virtualCards virtualCards = new virtualCards();
virtualcardpayload virtualcardpayload = new virtualcardpayload():
virtualcardpayload.setId(id);
virtualcardpayload.setSecret_Key(secret_key);

String response = virtualCards.dovirtualcardterminate(virtualcardpayload);

Sample Code to fund a virtual card.

virtualCards virtualCards = new virtualCards();
fundcardpayload fundcardpayload = new fundcardpayload():
fundcardpayload.setId(id);
fundcardpayload.setAmount(amount);
fundcardpayload.setDebit_currency(debit_currency);
fundcardpayload.setSecret_Key(secret_key);

String response = virtualCards.dovirtualcardfund(fundcardpayload);

Sample Code to get a virtual card transaction.

virtualCards virtualCards = new virtualCards();
fetchcardpayload fetchcardpayload = new fetchcardpayload():
fetchcardpayload.setId(id);
fetchcardpayload.setFromDate(FromDate);
fetchcardpayload.setToDate(ToDate);
fetchcardpayload.setPageIndex(PageIndex);
fetchcardpayload.setPageSize(pagesize);
fetchcardpayload.setCardId(cardid);
fetchcardpayload.setSecret_Key(secret_key);

String response = virtualCards.dovirtualcardfetchtrans(fetchcardpayload);

---

virtualCards virtualCards = new virtualCards();
withdrawcardpayload withdrawcardpayload = new withdrawcardpayload():
withdrawcardpayload.setCard_id(card_id);
withdrawcardpayload.setAmount(amount);
withdrawcardpayload.setSecret_Key(secret_key);

String response = virtualCards.dovirtualcardfwithdraw(withdrawcardpayload);

Ebills

Sample Code to create Ebills

ebills ebills = new ebills();
ebillpayload ebillpayload = new ebillpayload();
ebillpayload.setAccountnumber(accountnumber);
ebillpayload.setNarration(narration);
ebillpayload.setNumberofunits(numberofunits);
ebillpayload.setCurrency(currency);
ebillpayload.setAmount(amount);
ebillpayload.setPhonenumber(phonenumber);
ebillpayload.setEmail(email);
ebillpayload.setTxRef(txref);
ebillpayload.setSeckey(SECKEY);

String response = ebills.doebillscreate(ebillpayload);

Sample Code to update Ebills

ebills ebills = new ebills();
ebillpayload ebillpayload = new ebillpayload();
ebillpayload.setReference(reference);
ebillpayload.setCurrency(currency);
ebillpayload.setAmount(amount);
//ebillpayload.setSeckey(SECKEY);

String response = ebills.doebillsupdate(ebillpayload);

Refund

Sample code to refund a transaction

Refund refund = new Refund();
refundPayload refundpayload = new refundPayload();
refundpayload.setRef(ref);
refundpayload.setAmount(amount);
refundpayload.setSceretKey(seckey);

String response = refund.dorefund(refundpayload);

Tokenized Charge

Sample code for charging tokenised cards

tokenCharge tokencharge = new tokenCharge();
tokenChargePayload tokenchargepayload = new tokenChargePayload();
tokenchargepayload.setCurrency(currency);
tokenchargepayload.setToken(token);
tokenchargepayload.setAmount(amount);
tokenchargepayload.setEmail(email);
tokenchargepayload.setFirstname(firstname);
tokenchargepayload.setLastname(Lastname);
tokenchargepayload.setTxRef(texref);
tokenchargepayload.setSECKEY(Seckey);

String response = tokencharge.dotokenizedcharge(tokenchargepayload);

Sample code to update email for a token

tokenCharge tokencharge = new tokenCharge();
tokenChargePayload tokenchargepayload = new tokenChargePayload():
tokenchargepayload.setEmail(email);
tokenchargepayload.setToken(token);
tokenchargepayload.setSECKEY(Seckey);
String response = tokencharge.dotokenizedcharge(tokenchargepayload);

Payment plan

Sample code to create payment plan

paymentplan paymentplan = new paymentplan();
pamentplancreatepayload pamentplancreatepayload = new pamentplancreatepayload();
pamentplancreatepayload.setSeckey(seckey);
pamentplancreatepayload.setamount(amount);
pamentplancreatepayload.setname(name);
pamentplancreatepayload.setinterval(interval);
pamentplancreatepayload.setduration(duration);

String response = paymentplan.docreatepayment(pamentplancreatepayload);

Sample code to list payment plan

paymentplan paymentplan = new paymentplan();
paymentplanfetch paymentplanfetch = new paymentplanfetch();
paymentplanfetch.setSeckey(seckey);
paymentplanfetch.setid(id);
paymentplanfetch.setq(q);

String response = paymentplan.dopaymentplanlist(paymentplanfetch);

Sample code to cancel payment plan

paymentplan paymentplan = new paymentplan();
paymentplanfetch paymentplanfetch = new paymentplanfetch();
paymentplanfetch.setid(id);
paymentplanfetch.setSeckey(seckey);

String response = paymentplan.dopaymentplanlist(paymentplanfetch);

Verify Transactions

Sample code to verify transactions

transValidation transValidation = new transValidation();
transverifyPayload transverifyPayload . = new transverifyPayload();
transverifyPayload.setSECKEY(sckey);
transverifyPayload.settxref(txref);

String response = transValidation.bvnvalidate(transverifyPayload);

Subaccount

Sample code to list subaccounts

subaccounts subaccounts = new subaccounts();
subaccountpayload subaccountpayload = new subaccountpayload();
subaccountpayload.setSECKEY(sckey);

String response = subaccounts.dosubaccountslist(subaccountpayload);

Sample code to get a subaccount

subaccounts subaccounts = new subaccounts();
subaccountpayload subaccountpayload = new subaccountpayload();
subaccountpayload.setSECKEY(sckey);
subaccountpayload.setId(id);

String response = subaccounts.dosubaccountsget(subaccountpayload);

Sample code to create a subaccount

subaccounts subaccounts = new subaccounts();
subaccountpayload subaccountpayload = new subaccountpayload();

subaccountpayload.setSECKEY(seckey);
subaccountpayload.setaccount_bank(account_bank);
subaccountpayload.setaccount_number(account_number);
subaccountpayload.setbusiness_name(business_name);
subaccountpayload.setbusiness_email(business_email);
subaccountpayload.setbusiness_contact(business_contact);
subaccountpayload.setbusiness_contact_mobile(business_contact_mobile);
subaccountpayload.setmetaname(metaname);
subaccountpayload.setmetavalue(metavalue);

String response = subaccounts.dosubaccountscreate(subaccountpayload);

Sample code to delete a subaccount

subaccounts subaccounts = new subaccounts();
subaccountpayload subaccountpayload = new subaccountpayload();

subaccounts subaccounts = new subaccounts();
subaccountpayload subaccountpayload = new subaccountpayload();
subaccountpayload.setSECKEY(sckey);
subaccountpayload.setId(id);

String response = subaccounts.dosubaccountsdelete(subaccountpayload);

Bank Account

Sample code for bank account payment

bankPayments bankPayments = new bankPayments();
bankPayload bankpayload = new bankPayload();
bankpayload.setPBFPubKey(PBFPubKey);
bankpayload.setaccountbank(accountbank);
bankpayload.setaccountnumber(accountnumber);
bankpayload.setcurrency(currency);
bankpayload.setpayment_type(payment_type);
bankpayload.setcountry(country):
bankpayload.setamount(amount);
bankpayload.setemail(email);
bankpayload.setpasscode(passcode);
bankpayload.setbvn(bvn);
bankpayload.setphonenumber(phonenumber):
bankpayload.setfirstname(firstname);
bankpayload.setlastname(lastname);
bankpayload.settxRef(txRef);
bankpayload.setdevice_fingerprint(device_fingerprint);
bankpayload.setredirect_url(redirect_url);
bankpayload.setSECKEY(SECKEY):
//if split payment set subaccount values

String response = bankPayments.doflwbankpayment(bankpayload);

//validate payment
//then verify payment
transValidation transValidation = new transValidation();
transverifyPayload transverifyPayload = new transverifyPayload();
transverifyPayload.settxref(txref);
transverifyPayload.setSECKEY(SECKEY);

String response = transValidation.bvnvalidate(transverifyPayload);

Pre-Auth

Sample code for pre-auth capture

capturePreauth capturePreauth = new capturePreauth();
capturePayload capturepayload = new capturepayload();
capturepayload.setSECKEY(SECKEY);
capturepayload.setflwRef(flwRef);
capturepayload.setamount(amount);

String response = capturePreauth.docapture(capturepayload);

Sample code for pre-auth return or void

actionPreauth actionPreauth = new actionPreauth();
capturePayload capturepayload = new capturepayload();
capturepayload.setSECKEY(SECKEY);
capturepayload.setref(ref);
capturepayload.setaction(action);
//action can be refund or void

String response = actionPreauth.docapture(capturepayload);