Virtual Gateway

The Virtual Gateway is a simple internal gateway that simulates the online payment process, which helps the application development and testing. In another word, you don't need to have a real bank account to test your application.

• Configuration
• Enabling the Virtual Gateway
• • ASP.NET CORE
• • ASP.NET MVC
• • ASP.NET WebForms
• Usage

Configuration

To use the Virtual Gateway, you need to add it to the list of gateways and configure it.

   services.AddParbad()
           .ConfigureGateways(gateways =>
           {
              gateways
                   .AddParbadVirtual()
                   .WithOptions(options => options.GatewayPath = "/WriteAPathHere");
           })

Note: Make sure that the GatewayPath starts with a "/". Example: /MyVirtualGateway

Enabling the Virtual Gateway

ASP.NET CORE

Install the AspNetCore package:

Install-Package Parbad.AspNetCore

Startup.cs file:

public void Configure(IApplicationBuilder app)
{
   app.UseMvc(routes =>
   {
      routes.MapRoute(
               name: "default",
               template: "{controller=Home}/{action=Index}/{id?}");
   });

   // Register the Virtual Gateway
   app.UseParbadVirtualGateway();
}

ASP.NET MVC

Install the MVC package:

Install-Package Parbad.Mvc5

Startup.cs file:

public void Configuration(IAppBuilder app)
{
   var parbadBuilder = ParbadBuilder.CreateDefaultBuilder()
                                    // configurations

   // Register Parbad using a DI library such as Autofac.
   containerBuilder.Populate(parbadBuilder.Services);

   // Add the Parbad Virtual Gateway
   // Get IServiceProvider required by Parbad Virtual Gateway from the DI library.
   var serviceProvider = container.Resolve<IServiceProvider>();
   app.UseParbadVirtualGateway(serviceProvider);
}

ASP.NET WebForms

Install the Owin package:

Install-Package Parbad.Owin

Startup.cs file:

public void Configuration(IAppBuilder app)
{
   var parbadBuilder = ParbadBuilder.CreateDefaultBuilder()
                                    // configurations
                                    .Build();

   // Add the Parbad Virtual Gateway
   app.UseParbadVirtualGateway(parbadBuilder.Services);
}

Usage

var result = await _onlinePayment.RequestAsync(invoice =>
{
   invoice
      .SetTrackingNumber(123)
      .SetAmount(2000)
      .SetCallbackUrl("http://www.mywebsite.com/foo/bar/")
      .SetGateway("ParbadVirtual")
      // OR
      .UseParbadVirtual()
});

if (result.IsSucceed)
{
   return result.GatewayTransporter.TransportToGateway();
}

Parbad will redirect the client to the Virtual Gateway.