Follow

Payment Processing with SumUp: an integration without any line of code for iOS

In this post, I’d like to showcase how you can, by leveraging our report & platform feature, directly invoice / process the payment on field – to improve the Real-Time experience of your customers. For the payment app, we will rely on a 3rd party app called Sum Up, which handle the payment processing part.

To achieve this, we will proceed with the following 3 Steps:

  1. Create a SumUp account, which will represent your “Merchant” account on which you want the payments to be invoiced.
  2. Create a customized Report that contains a special link, which, by clicking it, will call the Sum-up App
  3. That’s it!

Create a SumUp Account

 

 Open an account on www.sumup.com. This account should represent the “Merchant” account and linked with the bank account on which the money is transferred.

Log-in and in the “Developers” Section, generate an access key

You now also need to add the “Application identifier” for the application that you want to support (in our case, the coresuite App: ch.coresystems.CoresuiteMobile).

Once you’ve executed these steps, you should see, under your SumUp account, the following information:

 

 

Create a Customized Report

If not already done, you’ll first need to install jasper report to be able to create/customize your own reports. For this, follow the getting started guide.

Now we will customize the existing Sales Report and add it a button that will call the SumUp iOS App for processing the payment. For doing this:

  1. Download the original “sales” report by selecting Project=>”Download Report from Coresuite Cloud”, select your connection, select the “sales” report and click “Finish”. Jasper will now create a new “sales” project in the “Project Explorer”
  1. In the Project Explorer, select the “report.jrxml” file (double-click it). This will open the “sales” report that we want to modify

  2. Now, we will add a new “Pay” button that will call the SumUp App: in the Palette window, drag and drop the a Text Field on the Report Design
  1. In the Properties, select the “Hyperlink” Tab, and in the Hyperlink Properties, set the properties exactly like this:
  2. In the “Hyperlink properties, select the Expression editor:
  1. In the following URL, replace the affiliate key (c9999999-9999-9999-9999-cb999999999) with your own Sum-Up affiliate key. Copy and paste then the following URL in the Expression Editor:

    "sumupmerchant://pay/1.0?amount=" + $V{totalGross} + "&currency=" + $V{currency} + "&affiliate-key=c9999999-9999-9999-9999-cb999999999"

  1. Optionaly, you can change the look & feel of the Text Field to make it look like a “Pay” Button, by changing “Color” parameters of the “Appearance” Tab, and changing the “Font” parameters of the “Text Field Tab”
  1. Now, Save all (Ctrl+Shift+S) and upload the report by using “Project => Upload Report to Coresuite Cloud”. Give the report a new name (e.g. “Sales & Invoice”) and upload it in the sales category.
    Note: you don’t need to compile. Compiling will throw errors – you can ignore them.
  1. Start the iPhone App, login in the account on which you uploaded the report. Go in your “Sales Order” section, select the Sales Order you want to charge to the customer, and in the Share Menu (icon on the top-left), choose “Print & Send”.
  1. Make sure that you select the newly uploaded report (e.g. “Sales & Invoice”), Press Preview, and choose “Pay”. This will open the SumUp App and will allow you to process the payment with the predefined amount of the Sales Report:

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.