Skip to content

shamnu/PayPal.Forms

 
 

Repository files navigation

PayPal.Forms

PayPal Plugin for Xamarin.Forms

Setup

##iOS & Android

In MainActivity(Android)/AppDelegate(iOS) after "Forms.Init()" call the Init method with your PayPal config value

...
global::Xamarin.Forms.Forms.Init ();
 CrossPayPalManager.Init(new PayPalConfiguration(
					PayPalEnvironment.NoNetwork,
					"Your PayPal ID from https://developer.paypal.com/developer/applications/"
					)
					{
					  //If you want to accept credit cards
					  AcceptCreditCards = true,
				  	//Your business name
					  MerchantName = "Test Store",
					  //Your privacy policy Url
					  MerchantPrivacyPolicyUri = "https://www.example.com/privacy",
					  //Your user agreement Url
					  MerchantUserAgreementUri = "https://www.example.com/legal",
					  
					  // OPTIONAL - ShippingAddressOption (Both, None, PayPal, Provided)
					  ShippingAddressOption = ShippingAddressOption.Both,
					  
					  // OPTIONAL - Language: Default languege for PayPal Plug-In
					  Language = "es",
					  
					   // OPTIONAL - PhoneCountryCode: Default phone country code for PayPal Plug-In
					  PhoneCountryCode = "52",
				  }
			);
...

##iOS

From official PayPal SDK page (https://github.com/paypal/PayPal-iOS-SDK#with-or-without-cocoapods) follow the two steps:

  • Add the open source license acknowledgments
  • Add squemas into Info.plist

###VERY IMPORTANT FOR IOS 10 IF YOU WANT TO USE THE CAMERA FEATURES

Add "NSCameraUsageDescription" into you Info.plist file.

<key>NSCameraUsageDescription</key>
<string>We will use your camera to scan the credit card</string>

##Android

YOU MUST NEED TO HAVE INSTALLED THE NEXT PACKAGE

https://www.nuget.org/packages/Square.OkHttp3/

Is very important to add the following code inside your OnActivityResult and OnDestroy on your main activity class

protected override void OnActivityResult (int requestCode, Result resultCode, Intent data)
{
	base.OnActivityResult (requestCode, resultCode, data);
	PayPalManagerImplementation.Manager.OnActivityResult(requestCode, resultCode, data);
}

protected override void OnDestroy()
{
	base.OnDestroy();
	PayPalManagerImplementation.Manager.Destroy();
}

Usage

##Single Item

var result = await CrossPayPalManager.Current.Buy (new PayPalItem ("Test Product", new Decimal (12.50), "USD"), new Decimal (0));
if (result.Status == PayPalStatus.Cancelled) {
	Debug.WriteLine ("Cancelled");
}else if(result.Status == PayPalStatus.Error){
	Debug.WriteLine (result.ErrorMessage);
}else if(result.Status == PayPalStatus.Successful){
	Debug.WriteLine (result.ServerResponse.Response.Id);
}

##List of Items

var result = await CrossPayPalManager.Current.Buy (new PayPalItem[] {
				new PayPalItem ("sample item #1", 2, new Decimal (87.50), "USD",
					"sku-12345678"), 
				new PayPalItem ("free sample item #2", 1, new Decimal (0.00),
					"USD", "sku-zero-price"),
				new PayPalItem ("sample item #3 with a longer name", 6, new Decimal (37.99),
					"USD", "sku-33333") 
			}, new Decimal (20.5), new Decimal (13.20));
if (result.Status == PayPalStatus.Cancelled) {
	Debug.WriteLine ("Cancelled");
}else if(result.Status == PayPalStatus.Error){
	Debug.WriteLine (result.ErrorMessage);
}else if(result.Status == PayPalStatus.Successful){
	Debug.WriteLine (result.ServerResponse.Response.Id);
}

##Shipping Address (Optional)

//Optional shipping address parameter into Buy methods.
var result = await CrossPayPalManager.Current.Buy(
			new PayPalItem(
				"Test Product",
				new Decimal(12.50), "USD"),
				new Decimal(0),
				new ShippingAddress("My Custom Recipient Name", "Custom Line 1", "", "My City", "My State", "12345", "MX")
		   );
if (result.Status == PayPalStatus.Cancelled)
{
	Debug.WriteLine("Cancelled");
}
else if (result.Status == PayPalStatus.Error)
{
	Debug.WriteLine(result.ErrorMessage);
}
else if (result.Status == PayPalStatus.Successful)
{
	Debug.WriteLine(result.ServerResponse.Response.Id);
}

##Future Payments

var result = await CrossPayPalManager.Current.RequestFuturePayments();
if (result.Status == PayPalStatus.Cancelled) {
	Debug.WriteLine ("Cancelled");
}else if(result.Status == PayPalStatus.Error){
	Debug.WriteLine (result.ErrorMessage);
}else if(result.Status == PayPalStatus.Successful){
	//Print Authorization Code
	Debug.WriteLine(result.ServerResponse.Response.Code);
}

##Profile sharing

var result = await CrossPayPalManager.Current.AuthorizeProfileSharing();
if (result.Status == PayPalStatus.Cancelled) {
	Debug.WriteLine ("Cancelled");
}else if(result.Status == PayPalStatus.Error){
	Debug.WriteLine (result.ErrorMessage);
}else if(result.Status == PayPalStatus.Successful){
	Debug.WriteLine (result.ServerResponse.Response.Code);
}

##Obtain a Client Metadata ID

//Print Client Metadata Id
Debug.WriteLine(CrossPayPalManager.Current.ClientMetadataId);

##Standalone Card Scanner

//Optional parameter CardIOLogo("PayPal", "CardIO" or "None") for ScanCard method by default "PayPal" is used
var result = await CrossPayPalManager.Current.ScanCard();
if (result.Status == PayPalStatus.Cancelled)
{
	Debug.WriteLine("Cancelled");
}
else if (result.Status == PayPalStatus.Successful)
{
	if (result.Card.CardImage != null)
	{
		CardImage.Source = result.Card.CardImage;
	}
	Debug.WriteLine($"CardNumber: {result.Card.CardNumber}, CardType: {result.Card.CardType.ToString()}, Cvv: {result.Card.Cvv}, ExpiryMonth: {result.Card.ExpiryMonth}");
	Debug.WriteLine($"ExpiryYear: {result.Card.ExpiryYear}, PostalCode: {result.Card.PostalCode}, RedactedCardNumber: {result.Card.RedactedCardNumber}, Scaned: {result.Card.Scaned}");
}

Nuget

Known Issues

  • On Xamarin Studio 5.10.X you will receive an alert that xamarin cant resolve "xamarin.paypal" and/or "paypal.forms" lib name this will be fixed by upgrading to Xamarin Studio 6 in beta/alpha channel(recommended) or downgrading to Xamarin Studio 5.9(not recommended)

TODO

No new tasks to do. All issues or features requests are welcome

About

PayPal Plugin for Xamarin.Forms

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 99.8%
  • Smalltalk 0.2%