> ## Documentation Index
> Fetch the complete documentation index at: https://flutterwaveinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Flutterwave .NET Library

> The Flutterwave .NET SDK makes it easy to add our payment features to your .NET web applications.

The Flutterwave .NET Library implements the following payment services:

1. Card Payments
2. Bank Account Payments.
3. Mobile Money Payments.
4. Bank Transfer (NGN).
5. Subscriptions.
6. Virtual Cards.

The Library also implements the following features:

1. Tokeniztion
2. Subaccounts
3. Currencies.
4. Pre-Authorisation.
5. Refunds.

## Prerequisites

* .NET 4.5 or later

## Installation

## Configuration

1. Add all relevant modules

```cs theme={null}
using System.Diagnostics;
using System.Collections.Generic;
using Rave.Models.MobileMoney;
using Rave.Models.VirtualCard;
using Rave.Models.Subaccount;
using Rave.Models.Tokens;
using Rave.Models;
using Rave.Models.Charge;
using Rave.Models.Account;
using Rave.Models.Card;
using Rave.Models.Validation;
using NUnit.Framework;
```

2. Pass Public and Secret keys as variables for configuration.

```cs theme={null}
private static string PbKey = "pass your public key here"
private static string ScKey = "pass your secret key here"
var raveConfig = new RaveConfig(PbKey, SCKey, false);
```

# Payments

## Card Payments

This implements Card payments for Pin, 3D-Secure, VBV and PreAuth transactions.

## Usage

1. Complete basic configuration following the configuration steps.

2. Configure the card charge

```cs theme={null}
var cardCharge = new ChargeCard(raveConfig);
```

3. Pass Card parameters as payload.
   The payload should contain:

* `Public key`
* `First name`
* `Last name`
* `Email address`
* `Amount`
* `Card details.`

These card details include:

* `Card number`
* `CVV`
* `Expiry month`
* `Expiry year`
* `Trans Ref`

```cs theme={null}
`var Payload = new CardParams(PbKey, "Anonymous", "Customer", "tester@example.com", 2100){ cardNo = "5438898014560229", Cvv = "789", Expirymonth = "09", Expiryyear = "19", TxRef = tranxRef}
```

4. Charge card.

```cs theme={null}
var cha = cardCharge.Charge(Payload).Result;
```

5. Pass Pin and OTP to complete the Transaction

```cs theme={null}
 if (cha.Message == "AUTH_SUGGESTION" && cha.Data.SuggestedAuth == "PIN")
            {
                cardParams.Pin = "3310";
                cardParams.Otp = "12345";
                cardParams.SuggestedAuth = "PIN";
                cha = cardCharge.Charge(Payload).Result;
            }
```

**The complete card charge and validation flow:**

```cs theme={null}
    class Program
    {
        private static string tranxRef = "454839";
        private static string PbKey = "";
        private static string ScKey = "";
        static void Main(string[] args)
        {
            
            var raveConfig = new RaveConfig(PbKey, ScKey, false);
            var cardCharge = new CardCharge(raveConfig);

            var Payload = new CardChargeParams(PbKey, "Anonymous", "Customer", "tester@example.com", 2100)
            { CardNo = "5438898014560229", Cvv = "789", Expirymonth = "09", Expiryyear = "19", TxRef = tranxRef }
            ;
            var cha = cardCharge.Charge(cardParams).Result;


            if (cha.Message == "AUTH_SUGGESTION" && cha.Data.SuggestedAuth == "PIN")
            {
                cardParams.Pin = "3310";
                cardParams.Otp = "12345";
                cardParams.SuggestedAuth = "PIN";
                cha = cardCharge.Charge(Payload).Result;
            }


        }
    }
    
```

## Account Payments

This implements direct debit transactions from Bank accounts.

## Usage

1. Complete basic configuration following the configuration steps.

2. Configure the Account charge

```cs theme={null}
var accountCharge = new ChargeAccount(raveConfig);
```

3. Pass Account parameters as payload. The payload should contain:

* `Public key`
* `First name`
* `Last name`
* `Email address`
* `Account number`
* `Amount`
* `Bank code.`
* `Currency (NGN)`
* `Trans Ref`

```cs theme={null}
var Payload = new AccountParams(PbKey, "Anonymous", "customer", "user@example.com", "0690000031", 1000.00m, "044", "NGN", "MC-0292920");
```

4. Charge Account.

```cs theme={null}
var chargeResponse = await accountCharge.Charge(accountParams);

if (chargeResponse.Data.Status == "success-pending-validation")
{
      // This usually means the user needs to validate the transaction with an OTP
      accountParams.Otp = "12345";
      chargeResponse = accountCharge.Charge(accountParams).Result;
}

Trace.WriteLine(chargeResponse.Data.ValidateInstructions.Instruction);
Trace.WriteLine(chargeResponse.Data.ValidateInstructions.Valparams);
Trace.WriteLine(chargeResponse.Data.ValidateInstruction);          
```

**The complete card charge and validation flow:**

```cs theme={null}
class Program
    {
        private static string tranxRef = "454839";
        private static string PbKey = "";
        private static string ScKey = "";
        static void Main(string[] args)
        {
            
            var raveConfig = new RaveConfig(recurringPbKey, recurringScKey, false);
            var accountCharge = new ChargeAccount(raveConfig);

            var Payload = new AccountParams(PbKey, "Anonymous", "customer", "user@example.com", "0690000031", 1000.00m, "044", "MC-0292920");
            var chargeResponse = await accountCharge.Charge(accountParams);


            if (chargeResponse.Data.Status == "success-pending-validation")
            {
                // This usually means the user needs to validate the transaction with an OTP
                accountParams.Otp = "12345";
                chargeResponse = accountCharge.Charge(accountParams).Result;
            }


            Trace.WriteLine(chargeResponse.Data.ValidateInstructions.Instruction);
            Trace.WriteLine(chargeResponse.Data.ValidateInstructions.Valparams);
            Trace.WriteLine(chargeResponse.Data.ValidateInstruction);
            ValidateAccountCharge(chargeResponse.Data.FlwRef);


        }
    }
    
```

## Mobile Money Payments

This implements Mpesa, Ghana, Uganda, Zambia and Rwanda Mobile money transactions for customers.

## Usage

1. Complete basic configuration following the configuration steps.

2. Configure the Mobile money charge

```cs theme={null}
var mobilemoney = new ChargeMobileMoney(raveConfig);
```

3. Pass mobile money parameters as payload. The payload should contain:

* `Public key`
* `Secret key`
* `First name`
* `Last name`
* `Email address`
* `Amount`
* `Currency`
* `Mobile number`
* `Network`
* `Country`
* `Payment Type`
* `Trans Ref`

```cs theme={null}
var Payload = new MobileMoneyParams(PbKey, ScKey, "Anonymous", "customer", "user@example.com",  1055, "GHS", "054709929220", "network", "country", "paymentType", "MC-0292920");
```

The payload parameters differ for different countries, currencies and payment types.

| Country | Payment Type        | Country code | Currency | Network               |
| ------- | ------------------- | ------------ | -------- | --------------------- |
| Ghana   | `mobilemoneygh`     | `GH`         | GHS      | `MTN, VODAFONE, TIGO` |
| Kenya   | `mpesa`             | `KE`         | KES      |                       |
| Rwanda  | `mobilemoneygh`     | `NG`         | RWF      | `RWF`                 |
| Zambia  | `mobilemoneyzambia` | `NG`         | ZMW      | `MTN`                 |
| Uganda  | `mobilemoneyuganda` | `UG`         | UGX      | `UGX`                 |

4. Carry out mobile money charge

```cs theme={null}
var cha = mobilemoney.Charge(Payload).Result;
```

**The Complete flow for mobile money charge:**

```cs theme={null}
class Program
    {
        private static string tranxRef = "454839";
        private static string PbKey = "";
        private static string ScKey = "";
        static void Main(string[] args)
        {
            
            var raveConfig = new RaveConfig(recurringPbKey, recurringScKey, false);
            var mobilemoney = new ChargeMobileMoney(raveConfig);

            var Payload = new MobileMoneyParams(PbKey, ScKey, "Anonymous", "customer", "user@example.com",  1055, "GHS", "054709929220", "MTN", "GH", "mobilemoneygh", tranxRef);
            var cha = mobilemoney.Charge(Payload).Result;
        }
```

## Bank Transfers

This shows how to create an account number for customers to pay you with using the pay with bank transfer feature.

## Usage

**Static Accounts:**

```cs theme={null}
   var virtualacct = new VirtualAccount();
   var virtualaccountparams = new VirtualAccountParams(narration, ScKey, email, reference);
   var chargeResponse = virtuala.CreateStaticVirtualAccount(virtualaccountparams);

```

**Transaction Accounts:**

```cs theme={null}
    var virtuala = new VirtualAccount();
    var virtualaccountparams = new VirtualAccountParams(narration, ScKey, email, reference, amount);
    var chargeResponse = virtuala.CreateTransactionVirtualAccount(virtualaccountparams);

```

**Duration Accounts:**

```cs theme={null}
    var virtuala = new VirtualAccount();
    var virtualaccountparams = new VirtualAccountParams(frequency, durtion, narration, ScKey, email, ref, amount);
    var chargeResponse = virtuala.CreateTransactionVirtualAccount(virtualaccountparams);

```

## Ebills

This API allows you to create and update a new Ebills order.

## Usage

**Create Ebills:**

```cs theme={null}
    var ebillscreate = new CreateOrder();
    var ebillscreateparams = new EbillsCreateRequestParams(currency, numberofunits, narraction, ScKey, email, amount, phonenumber, txRef, IP);
    var chargeResponse = ebillscreate.doCreateOrder(ebillscreateparams);

```

**Update Ebills:**

```cs theme={null}
      var ebillsupdate = new UpdateOrder();
      var ebillsupdateparams = new EbillsUpdateRequestParams(currency, ScKey, amount, flwref");
      var chargeResponse = ebillsupdate.doUpdateOrder(ebillsupdateparams);

```

## Tokenization

This implements Card tokenization for Pin, 3D-Secure, VBV and NoAuth cards.

## Usage

1. Complete basic configuration following the configuration steps.

2. Charge the card using instructions from the Card charge section of the documentation.

3. Configure the tokenized card

```cs theme={null}
var tokenCard = new Tokenize(raveConfig);
```

4. Pass tokenized card parameters as payload.
   The payload should contain:

* `Secret key`
* `First name`
* `Last name`
* `Email address`
* `Transaction ref`
* `Amount`
* `currency`
* `embed token`
* `Narration`

```cs theme={null}
var Payload = new TokensParams(ScKey, "Anonymous", "Customer", "tester@example.com", tranxref, 2100, "NGN", "NG"){ Token = "flw-t1nf-139d69763063262928b77bc1f4fba199-m03k", Narration = "Test"};
```

5. Make tokenized charge.

```cs theme={null}
var tokenResponse = tokenCard.Charge(tokenparam).Result;
```

**The complete tokenized card charge:**

```cs theme={null}
    class Program
    {
        private static string tranxRef = "454839";
        private static string PbKey = "";
        private static string ScKey = "";
        static void Main(string[] args)
        {
            
            var raveConfig = new RaveConfig(PbKey, ScKey, false);
            var cardCharge = new CardCharge(raveConfig);

            var Payload = new TokensParams(ScKey, "Anonymous", "Customer", "tester@example.com", tranxref, 2100, "NGN", "NG"){ Token = "flw-t1nf-139d69763063262928b77bc1f4fba199-m03k", Narration = "Test"};
            
            var tokenResponse = tokenCard.Charge(tokenparam).Result;

        }
    }
    
```

## SubAccounts

This implements subaccount creation for split payments.

## Usage

1. Complete basic configuration following the configuration steps.

2. Configure the SubAccount

```cs theme={null}
var subacc = new CreateSubAccount(raveConfig);
```

3. Pass tokenized card parameters as payload.
   The payload should contain:

* `Secret key`
* `Account Bank`
* `Account number`
* `Business Name`
* `Business Email`
* `Business contact `
* `Business contact  mobile`

```cs theme={null}
var payload = new SubAccountParams(ScKey, "0690000031", "0690000031", "TEST BUSINESS", "user@example.com", "0900000000", "0900000000");
```

please note that the same value can be passed as business contact and business contact number.

4. Create the Subaccount.

```cs theme={null}
var chargeResponse = subacc.Charge(payload).Result;
```

**The complete subaccount creation flow:**

```cs theme={null}
    class Program
    {
        private static string tranxRef = "454839";
        private static string PbKey = "";
        private static string ScKey = "";
        static void Main(string[] args)
        {
            
            var raveConfig = new RaveConfig(PbKey, ScKey, false);
            var subacc = new CreateSubAccount(raveConfig);

            var payload = new SubAccountParams(ScKey, "0690000031", "0690000031", "TEST BUSINESS", "user@example.com", "0900000000", "0900000000");
            
            var chargeResponse = subacc.Charge(payload).Result;

        }
    }
    
```

## Support

For further assistance in using the SDK, you can contact the Developers on [Slack](https://join.slack.com/t/flutterwavedevelopers/shared_invite/enQtNTk3MjgxMjU3ODI5LWFkMjBkYTc0ZGJhM2Q5MTY3YjFkYzAyYmM1ZDZjZjUwMjE4YTc2NjQ1ZGM5ZWE4NDUxMzc4MmExYmI1Yjg5ZWU) and [Email](mailto:developers@flutterwavego.com). You can also check out some awesome Beta features [here](/api-reference/introduction).