Ogólne informacje o działaniu bibliotek mobilnych w systemie Przelewy24 znajdziesz pod adresem:
Przykład implementacji biblioteki:
W Visual Studio, w projekcie głównym i iOS należy dodać referencję (References -> Add References) do biblioteki P24Lib (plik P24Lib.dll)
W celu poprawnego działania biblioteki należy utworzyć widok TransferPage, który w code behind zawierał będzie:
public TransferPage(TrnDirectParams transactionParams)
{
var content = TransferPageHelper.ContentForTrnDirect(transactionParams);
Content = content;
}
public TransferPage(TrnRequestParams transactionParams)
{
var content = TransferPageHelper.ContentForTrnRequest(transactionParams);
Content = content;
}
public TransferPage(ExpressParams transactionParams)
{
var content = TransferPageHelper.ContentForExpress(transactionParams);
Content = content;
}
protected override bool OnBackButtonPressed()
{
if (TransferPageHelper.CanMoveToBankList())
{
DisposeWebView();
var newContent = TransferPageHelper.GetContentForBack();
Content = newContent;
return true;
}
else
{
DisposeWebView();
Content = null;
BanksUrl.Clear();
Navigation.PopAsync();
return true;
}
}
public void DisposeWebView() {
if (Content != null) {
(Content as WebViewWithProgress).DisposeWebView();
}
}
protected override void OnDisappearing() {
DisposeWebView();
}
public void CustomBackButtonAction()
{
OnBackButtonPressed();
}
}W projekcie iOS należy dodatkowo stworzyć klasę WebViewRenderer:
[assembly: ExportRenderer(typeof(P24WebView), typeof(WebViewRender))]
namespace P24XamarinLib.iOS
{
public class WebViewRender : WebViewRenderer
{
protected override void OnElementChanged(VisualElementChangedEventArgs e)
{
base.OnElementChanged(e);
var webView = e.NewElement as P24WebView;
if (webView != null)
{
webView.EvaluateJavascript = (js) =>
{
return Task.FromResult(this.EvaluateJavascript(js));
};
initRefreshCommand(webView);
}
}
private void initRefreshCommand(P24WebView p24WebView)
{
if (NativeView != null)
{
var uiWebView = (UIWebView)NativeView;
p24WebView.reloadAction = () =>
{
uiWebView.Reload();
};
}
}
}
}W projekcie iOS należy stworzyć klasę TransferPageRenderer:
[assembly: ExportRenderer(typeof(TransferPage), typeof(TransferPageRenderer))]
namespace P24XamarinLib.iOS
{
public class TransferPageRenderer : PageRenderer
{
public override void ViewWillAppear(bool animated)
{
base.ViewWillAppear(animated);
SetCustomBackButton();
}
private void SetCustomBackButton()
{
var backButtonItem = new UIBarButtonItem(string.Empty, UIBarButtonItemStyle.Plain, OnCustomBackButtonPress);
backButtonItem.Image = UIImage.FromBundle("backButton.png");
backButtonItem.ImageInsets = new UIEdgeInsets(0, -8, 0, 0);
NavigationController.TopViewController.NavigationItem.LeftBarButtonItem = backButtonItem;
}
private void OnCustomBackButtonPress(object sender, EventArgs e)
{
((P24TransferPage)Element)?.CustomBackButtonAction();
}
}
}Dodać grafikę backButton@2x.png do katalogu Resources.
W projekcie Android należy dodatkowo stworzyć klasę WebViewRenderer:
[assembly: ExportRenderer(typeof(P24WebView), typeof(WebViewRender))]
namespace P24XamarinLib.Droid
{
public class WebViewRender : WebViewRenderer
{
private P24WebViewClient webViewClient;
protected override void OnElementChanged(ElementChangedEventArgs<Xamarin.Forms.WebView> e)
{
base.OnElementChanged(e);
if (Control != null && e.NewElement != null)
{
InitializeCommands((P24WebView)e.NewElement);
}
}
private void InitializeCommands(P24WebView p24WebView)
{
p24WebView.reloadAction = () =>
{
Control?.Reload();
};
webViewClient = new P24WebViewClient(p24WebView);
Control?.SetWebViewClient(webViewClient);
p24WebView.OnDisposed += P24WebView_OnDisposed;
}
void P24WebView_OnDisposed(object sender, EventArgs e)
{
Control?.SetWebViewClient(null);
}
}
public class P24WebViewClient: WebViewClient {
private P24WebView p24WebView;
public P24WebViewClient(P24WebView webView) {
p24WebView = webView;
}
public override void OnPageStarted(Android.Webkit.WebView view, string url, Bitmap favicon)
{
p24WebView.OnNavigating(url.ToString());
base.OnPageStarted(view, url, favicon);
}
public override void OnPageFinished(Android.Webkit.WebView view, string url)
{
p24WebView.OnNavigated(url.ToString());
base.OnPageFinished(view, url);
}
public override void OnReceivedError(Android.Webkit.WebView view, [GeneratedEnum] ClientError errorCode, string description, string failingUrl)
{
p24WebView.OnError(view.Url.ToString());
base.OnReceivedError(view, errorCode, description, failingUrl);
}
}
}W klasie MainActivity projektu Andorid przeładować metodę:
public override bool OnOptionsItemSelected(IMenuItem item)
{
if (item.ItemId == Android.Resource.Id.Home) {
OnBackPressed();
return true;
}
return base.OnOptionsItemSelected(item);
}W tym celu należy stworzyć obiekt klasy TrnDirectParams i przy okazji ustawić parametry transakcji, podając Merchant Id i klucz do CRC:
var payment = new TrnDirectParams()
{
SessionId = XXXXXXXXXXXXX,
MerchantId = XXXXX,
Crc = XXXXXXXXXXXXX,
Amount = 1,
Language = "pl",
Currency = "PLN",
Address = "Ulica testowa",
City = "Poznan",
Zip = "61-600",
Client = "Jan Kowalski",
Country = "PL",
Email = "info@przelewy24.pl",
Phone = "23566345"
};Parametry opcjonalne:
payment.UrlStatus = "https://XXXXXX";
payment.Method = 25;
payment.TimeLimit = 90;
payment.Channel = 1;
payment.TransferLabel = "transfer label";
payment.Shipping = 0;Opcjonalne można ustawić wywołanie transakcji na serwer Sandbox:
payment.SetSandbox(true)Mając gotowe obiekty konfiguracyjne możemy przystąpić do wywołania widoku dla transakcji. Uruchomienie wygląda następująco:
var payment = GetTransferParams();
var transferPage = new TransferPage(payment.SetSandbox(setSandbox));
transferPage.Disappearing += (sender2, e2) => { TransferPageResult(); };
await Navigation.PushAsync(transferPage);Aby obsłużyć rezultat transakcji należy rozszerzyć metodę TransferPageResult:
private void TransferPageResult()
{
var result = Result.Get();
if (result != null)
{
if (result.IsSuccess)
{
// success
}
else
{
// error
var errorCode = result.ErrorCode;
}
}
else
{
//cancel
}
}TransferPage zwraca tylko informację o tym, że transakcja się zakończyła. Nie zawsze oznacza to czy transakcja jest zweryfikowana przez serwer partnera, dlatego za każdym razem po uzyskaniu statusu isSuccess aplikacja powinna odpytać własny backend o status transakcji.
Podczas rejestracji transakcji metodą "trnRegister" należy podać dodatkowe parametry:
p24_mobile_lib=1p24_sdk_version=X– gdzie X jest wersją biblioteki mobilnej otrzymana w wywołaniu metodyP24SdkVersion.value()
Dzięki tym parametrom system Przelewy24 będzie wiedział że powinien traktować transakcję jako mobilną. Token zarejestrowany bez tego parametru nie zadziała w bibliotece mobilnej (wystąpi błąd po powrocie z banku i okno biblioteki nie wykryje zakończenia płatności).
UWAGA!
Rejestrując transakcję, która będzie wykonana w bibliotece mobilnej należy pamiętać o dodatkowych parametrach:
p24_channel– jeżeli nie będzie ustawiony, to domyślnie w bibliotece pojawią się formy płatności „przelew tradycyjny” i „użyj przedpłatę”, które są niepotrzebne przy płatności mobilnej. Aby wyłączyć te opcje należy ustawić w tym parametrze flagi nie uwzględniające tych form (np. wartość 3 – przelewy i karty, domyślnie ustawione w bibliotece przy wejściu bezpośrednio z parametrami)p24_method– jeżeli w bibliotece dla danej transakcji ma być ustawiona domyślnie dana metoda płatności, należy ustawić ją w tym parametrze przy rejestracjip24_url_status- adres, który zostanie wykorzystany do weryfikacji transakcji przez serwer partnera po zakończeniu procesu płatności w bibliotece mobilnej
Należy ustawić parametry transakcji podając token zarejestrowanej wcześniej transakcji, opcjonalnie można ustawić serwer sandbox oraz konfigurację banków:
var token = "XXXX-XXXX-XXXX-XXXX"; // transaction token
var transferPage = new TransferPage(new TrnRequestParams(token).SetSandbox(setSandbox));
transferPage.Disappearing += (sender2, e2) => { TransferPageResult(); };
await Navigation.PushAsync(transferPage);Rezultat transakcji należy obsłużyć identycznie jak dla wywołania "trnDirect".
Należy ustawić parametry transakcji podając url uzyskany podczas rejestracji transakcji w systemie Ekspres. Transakcja musi być zarejestrowana jako mobilna.
var url = "https://XXX"; // url to express transaction
var transferPage = new TransferPage(new ExpressParams(url));
transferPage.Disappearing += (sender2, e2) => { TransferPageResult(); };
await Navigation.PushAsync(transferPage);Rezultat transakcji należy obsłużyć identycznie jak dla wywołania "trnDirect".
Należy ustawić parametry transakcji identycznie jak dla wywołania "trnDirect", dodając odpowiednio przygotowany obiekt koszyka:
payment.PassageCart = new PassageCart();
var item = new PassageItem()
{
Name = "Product 1",
Description = "description 1",
Quantity = 1,
Price = 100,
Number = 1,
TargetAmount = 100,
TargetPosId = 51986
};
payment.PassageCart.AddItem(item);
item = new PassageItem()
{
Name = "Product 2",
Description = "description 2",
Quantity = 1,
Price = 100,
TargetAmount = 100,
TargetPosId = 51987
};
payment.PassageCart.AddItem(item);Wywołanie transakcji oraz parsowanie wyniku jest realizowane identycznie jak dla wywołania "trnDirect".