{"type":"doc","content":[{"type":"paragraph"},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"On this page","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"1"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"5edf57d9-55e1-481c-a2e3-59b3bb6df4d1"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"64ed10c6-5df4-4247-9db7-aa118a2a1c52"}},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"General Questions, Service Desk, QA","type":"text"}]},{"type":"expand","attrs":{"title":"What type of support does Gini provide regarding the technical solution for bank developers?"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Developers portal","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://gini.net/en/developer"}}]},{"text":" with the technical documentation:","type":"text"},{"type":"hardBreak"},{"text":"- Gini Bank SDK documentation ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/GBSV"}},{"text":" ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/IBSV"}},{"type":"hardBreak"},{"text":"- API documentation ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/x/AwPUAQ"}},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Showcase apps","type":"text","marks":[{"type":"strong"}]},{"text":" with open-source code give the opportunity to check Gini product implementation and test your app against showcase apps:","type":"text"},{"type":"hardBreak"},{"text":"- ","type":"text"},{"text":"Android demo app","type":"text","marks":[{"type":"link","attrs":{"href":"https://install.appcenter.ms/orgs/gini-team-organization/apps/screen-api-example-gini-pay-bank-sdk/distribution_groups/public"}}]},{"type":"hardBreak"},{"text":"- ","type":"text"},{"text":"iOS demo app","type":"text","marks":[{"type":"link","attrs":{"href":"https://install.appcenter.ms/orgs/gini-team-organization/apps/example-gini-pay-bank-sdk/distribution_groups/public"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Joint QA sessions","type":"text","marks":[{"type":"strong"}]},{"text":" in the scope of Gini integration projects. We assist in organizing QA testing sessions, if needed, to address any technical questions specific to your environment and configuration. Additionally, we conduct a mandatory QA session as a final check to ensure everything is ready before your banking app, powered by Gini, goes live for your end users (bank clients).","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"Why does Gini recommend QA sessions?"},"content":[{"type":"paragraph","content":[{"text":"The primary purpose of a QA session is to do the last step of testing the app before going live. You can consider it a Sprint Review ceremony in SCRUM or similar. ","type":"text"}]},{"type":"paragraph","content":[{"text":"We usually organize QA sessions for our partners that integrate Gini Bank SDK. It is designed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for you ","type":"text","marks":[{"type":"strong"}]},{"text":"to do a final check and ask us the technical questions regarding the implementation of the SDK and best practices;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"for us ","type":"text","marks":[{"type":"strong"}]},{"text":"to ensure that the SDK is implemented according to the latest actual best practices from a technical and user experience perspective.","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"What does Gini check during a QA session?"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Photo Payment","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multipage ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Return Assistant (when enabled)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Skonto (when enabled)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Entry Point","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"QR Code","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PDF/Image Upload","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flash function","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open with","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"No result Screen","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"User management","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Web upload","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Transfer Summary (former Feedback) functionality*","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gini Pay connect**","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"*","type":"text"},{"text":"Transfer Summary (former Feedback) functionality","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"During the QA session, we are happy to assist you with testing the Transfer Summary (previously called Feedback) functionality. This critical part of the app requires our involvement for testing and cannot be handled solely by the Partner on the bank's side.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A properly implemented Transfer Summary ensures effective data monitoring, enabling you to gain valuable, actionable insights from your clients. These insights include metrics like the paid rate, which are crucial for driving business success.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"**Gini Pay Connect (separate session)","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gini Pay Connect is a digital payment solution that integrates insurance or healthcare apps, with banking apps to streamline invoice payments. Gini Pay Connect extracts and transfers the payment details to the banking app, where the user confirms the payment. ","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"How does Gini handle technical support?"},"content":[{"type":"paragraph","content":[{"text":"At Gini, we pride ourselves on providing top-notch technical support to ensure your experience with us is seamless. Here’s how we deliver outstanding assistance:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Support via Gini Technical Support","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Reach out to Gini Technical Support anytime at ","type":"text"},{"text":"technical-support@gini.net","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"mailto:technical-support@gini.net"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Your request will automatically generate a support ticket, allowing you to easily track its status and updates on the ","type":"text"},{"text":"Gini Technical Portal","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Centralized Support via the Gini Technical Portal","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access the ","type":"text"},{"text":"Gini Technical Portal","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://technical.portal.gini.net/servicedesk/customer/portals"}}]},{"text":" to log a technical support ticket, submit suggestions for product improvements, or stay informed via our real-time ","type":"text"},{"text":"Status Page","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://status.gini.net/"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The portal is designed to provide a seamless experience, empowering you to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Submit Support Requests:","type":"text","marks":[{"type":"strong"}]},{"text":" Easily describe your issue, track progress, and communicate with our team.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make Improvement Suggestions:","type":"text","marks":[{"type":"strong"}]},{"text":" Share ideas or feedback to help us enhance Gini's functionality and meet your specific needs.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Monitor System Status:","type":"text","marks":[{"type":"strong"}]},{"text":" Stay updated on the availability of Gini services, scheduled maintenance, or any incidents via the integrated Status Page.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Gini Technical Portal serves as your one-stop shop for support, feedback, and operational transparency.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Real-Time Assistance through Slack and MS Teams","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Connect directly with our support specialists via ","type":"text"},{"text":"Slack","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"Microsoft Teams","type":"text","marks":[{"type":"strong"}]},{"text":" for quick resolutions to urgent queries or ongoing discussions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Our team can be integrated into your workflows, ensuring real-time collaboration and fast response times.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expert Guidance Tailored to Your Needs","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Our highly skilled support engineers are well-versed in Gini’s technology and your unique setup, providing personalized assistance to address your specific environment, configuration, and requirements.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Proactive Support Features","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We don’t just wait for problems - we monitor Transfer Summary (feedback) and user reports from app reviews, to identify potential issues before they arise.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We also provide regular check-ins, system health reviews, and consultation sessions to keep your Gini integration running smoothly.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dedicated Support for Critical Milestones","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For key moments, such as going live or launching new features, we work alongside you with dedicated QA sessions, ensuring everything is optimized and thoroughly tested.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Comprehensive Documentation & Knowledge Base","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In addition to direct support, we provide a rich library of guides, FAQs, and best practices to empower your team to troubleshoot or optimize independently.","type":"text"}]}]}]}]}]}]},{"type":"expand","attrs":{"title":"How long will it take to solve our IT support issue? How do you handle technical issues occurring at night? What is the maximum delay to reply to our maintenance requests ?"},"content":[{"type":"paragraph","content":[{"text":"The first response by the technical solution consultant happens within a business day, normally within 2 hours.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Who is the data protection officer (DPO)? "},"content":[{"type":"paragraph","content":[{"text":"Dr. Sebastian Kraska, ","type":"text"},{"text":"datenschutz@gini.net","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:datenschutz@gini.net"}}]},{"text":", +49 89 189 173 60.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information about external data privacy officers, see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.iitr.de/"}},{"text":" ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Is Gini compliant with GDPR? "},"content":[{"type":"paragraph","content":[{"text":"Gini data processing is fully compliant with GDPR requirements and the German Data Protection Act (Bundesdatenschutzgesetz - BDSG).","type":"text"}]}]},{"type":"expand","attrs":{"title":"Why does Gini collect data on user behaviour (User Journey Tracking and Analysis) and how this relates to GDPR?"},"content":[{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"FAQ-UserJourney"},"legacyAnchorId":{"value":"FAQ-FAQ-UserJourney"}},"macroMetadata":{"macroId":{"value":"6af78df41edaa7ef6544ca39f2fc51c2f072d4bce2a12bd61c0c8b3c072dcde1"},"schemaVersion":{"value":"1"},"title":"Anchor"}},"localId":"220fb552-3b8b-4eed-820b-6e04a73ab66f"}},{"text":"We want to collect data on user behaviour for analysis purposes in order to better understand the user journey in our SDK and to gain insights into specific areas where product improvements can be made. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Tracking user journeys in the SDK, allows Gini to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"understand how users interact with our product and service. This can help in improving user experience, identifying pain points, and optimising the user interface.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"get valuable feedback for our product development. Gini can use this data to prioritise feature enhancements or new product developments based on user needs and behaviours within our SDK.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"evaluate the effectiveness of banking partners marketing campaigns. By analysing how users use our service, Gini can identify which marketing channels or strategies are most successful in driving desired outcomes for our partners.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Gini is very much familiar and conform GDPR requires businesses to obtain explicit consent from banks and their users. Gini ensures that the data is used for product improvements only and stored securely. Gini conducts user journey tracking in a transparent and responsible manner, respecting the privacy rights of banking app users while still benefiting from the valuable insights it provides.","type":"text"}]}]},{"type":"expand","attrs":{"title":"How does Gini collect and handle user data. I was asked to fill / update my app’s Data safety form for the Google Play Store. ? "},"content":[{"type":"paragraph","content":[{"text":"You can find the details for the Android Bank SDK here: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/GBSV/pages/196640770"}},{"text":" and for the Android Capture SDK here: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/SCSV/pages/198215053"}},{"text":" ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Can user tracking be enabled or disabled based on individual user preferences?"},"content":[{"type":"paragraph","content":[{"text":"Yes, user tracking can be adjusted based on individual preferences. Here's how it works.","type":"text"}]},{"type":"paragraph","content":[{"text":"iOS:","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A banking partner implements the tracking system and requests permissions from end-users.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Gini SDK can access these permission settings directly from the system.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a user declines tracking permissions, the Gini user journey tracking will be disabled for that specific user, even if it's enabled for the banking partner overall.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This ensures compliance with user preferences and privacy choices.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Android:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Currently, the individual user tracking preferences is not available for users on the Android platform. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Who is the chief information security officer (CISO)?"},"content":[{"type":"paragraph","content":[{"text":"We don't have a CISO, but an ISO.","type":"text"}]},{"type":"paragraph","content":[{"text":"Michael Poprat (ISO), ","type":"text"},{"text":"iso@gini.net","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:iso@gini.net"}}]},{"text":", +49 89 215 285 013.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Why can't we remove the documents immediately for data safety purposes?"},"content":[{"type":"paragraph","content":[{"text":"We need to store documents, extractions, and Transfer Summary (former Feedback) for four weeks to continuously improve the extraction quality of our machine-learning engine. This is the core functionality of Gini and the guarantor of success for the partners. Only so, Gini can ensure that the quality of the photo payment service offered to a customer is stable and can be continuously increased. When documents get deleted directly after the flow is finished, the learning mechanism can be trained to the incoming document and thus not adapted to the bank customers' needs which will result in a negative customer experience very soon. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"How long is an anounymous account, generated for each app installation, is retained and when is it deleted?"},"content":[{"type":"paragraph","content":[{"text":"We keep the documents of an anonymous user for ","type":"text"},{"text":"28 days","type":"text","marks":[{"type":"strong"}]},{"text":". The account is automatically deleted when the user is inactive for more than ","type":"text"},{"text":"365 days","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"expand","attrs":{"title":"How is Gini preparing to comply with the Accessibility Strengthening Act (Barrierefreiheitsstärkungsgesetz - BFSG) in Germany, which takes full effect on June 28, 2025?"},"content":[{"type":"paragraph","content":[{"text":"Gini is committed to meeting the requirements of the Accessibility Strengthening Act (Barrierefreiheitsstärkungsgesetz - BFSG) in Germany, which will come into full effect on June 28, 2025. In preparation, Gini has proactively implemented necessary measures to ensure that the Gini’s Bank SDK will fully comply with BFSG standards by the deadline.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Gini’s Bank SDK is already compliant with most of the requirements outlined in the WCAG 2.1 guidelines (a W3C recommendation) as specified by BFSG. Gini is diligently working to meet the remaining WCAG 2.1 standards, ensuring an accessible, user-friendly experience for all. You can stay updated on our progress ","type":"text"},{"text":"here in our Product Updates section","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/PU"}}]},{"text":".","type":"text"}]},{"type":"paragraph"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Capturing Invoices and QR Codes","type":"text"}]},{"type":"expand","attrs":{"title":"What QR types does Gini support?"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BezahlCode","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"http://www.bezahlcode.de/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"EPC069-12","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/quick-response-code-guidelines-enable-data-capture-initiation"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stuzza (AT)","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://www.stuzza.at/de/zahlungsverkehr/qr-code.html"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GiroCode (DE)","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://www.girocode.de/rechnungsempfaenger/"}}]}]}]}]}]},{"type":"expand","attrs":{"title":"What is a BezahlCode?"},"content":[{"type":"paragraph","content":[{"text":"It is very old and no longer exists. When Gini started the business it was still alive and therefore we still support it as a legacy.","type":"text"}]}]},{"type":"expand","attrs":{"title":"What is the difference between an EPC and a GiroCode?"},"content":[{"type":"paragraph","content":[{"text":"Girocode is only a marketing name for EPC.","type":"text"}]}]},{"type":"expand","attrs":{"title":"What is the the processing time of QR codes?"},"content":[{"type":"paragraph","content":[{"text":"The processing of QR codes happens on our server, so the response time is in the range ","type":"text"},{"text":"of 100ms to 200ms ","type":"text","marks":[{"type":"strong"}]},{"text":"at the moment.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Why can there be problems with the QR code recognition on Android? Is there an adjustment or currently an error? Meanwhile, everything is fine with iOS."},"content":[{"type":"paragraph","content":[{"text":"Earlier we used Google Library (Google Mobile Vision) where there were difficulties with QR codes that are Latin1 encoded and contain umlauts/special characters. This error occurs sporadically depending on the model loaded for the Google Mobile Vision. Therefore, we switched to ML Kit in an update (Gini Vision Library from version 4.3.1 and Gini Bank SDK from version 1.8.2). Make sure you use the updated versions in case of problems with implementation.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Why are QR codes not on the device?"},"content":[{"type":"paragraph","content":[{"text":"Gini performs remote extractions due to variations in QR code standards, ensuring seamless reading across different platforms. ","type":"text"}]},{"type":"paragraph","content":[{"text":"This centralized process allows us to adapt the QR code decoder swiftly for new invoice types, avoiding delays for users awaiting app updates. ","type":"text"}]},{"type":"paragraph","content":[{"text":"From a business perspective, it enables Gini to provide comprehensive KPI reports, covering QR codes, images, and PDF files. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"What information is sent to Gini when scanning QR code?"},"content":[{"type":"paragraph","content":[{"text":"→ When scanning QR codes, only the decoded text string is sent to Gini; the actual photo of the QR code is not transmitted. ","type":"text"}]},{"type":"paragraph","content":[{"text":"→ Also when using the “qrCodeOnly” configuration option: The QR code text string is sent to Gini.","type":"text"}]},{"type":"paragraph","content":[{"text":"→ In full operation mode:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a QR code is detected, the text string is sent to Gini.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a simple IBAN is recognized (when started from EntryPoint.FIELD), the entire image is sent to Gini for double-checking the IBAN and extracting additional fields (Amount, Recipient, and Purpose).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"→ If an invoice with a QR code is uploaded (not captured by the camera), then the image of the QR code is sent to Gini.","type":"text"}]}]},{"type":"expand","attrs":{"title":"What is the minimum information to be present for a QR code and a document?"},"content":[{"type":"paragraph","content":[{"text":"Firstly, we check the standard, secondly, we check IBAN. So the IBAN is the necessary field to be presented on a QR code in order to be recognized by Gini.","type":"text"}]},{"type":"paragraph","content":[{"text":"In general, we follow the specifications of ","type":"text"},{"text":"Data Capture for the Initiation of a SEPA Credit Transfer","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.europeanpaymentscouncil.eu/sites/default/files/kb/file/2022-09/EPC069-12%20v3.0%20Quick%20Response%20Code%20-%20Guidelines%20to%20Enable%20the%20Data%20Capture%20for%20the%20Initiation%20of%20an%20SCT_0.pdf"}}]},{"text":". However, as we see some invoices with missed mandatory fields, we follow the structure but make exceptions about the mandatory fields. We try to extract and return what we find. If only IBAN is detected, Gini returns only IBAN.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Should a document have a classic layout (top left invoice recipient, top right invoice number/date, and middle right total amount)? Can the invoice data be arranged differently?"},"content":[{"type":"paragraph","content":[{"text":"We accept all possible invoice layouts and Gini is not template-based. Even unusual invoice types should work, but it's better to check a specific example. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"How to achieve the best possible results when capturing images?"},"content":[{"type":"paragraph","content":[{"text":"These guidelines aim to help users achieve the best possible results when capturing images, promoting clarity, and ease of use during the scanning process. Following these recommendations will contribute to improved image quality and enhance the overall scanning experience.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optimal Lighting:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importance:","type":"text","marks":[{"type":"strong"}]},{"text":" Ensure better results by avoiding the use of flash and choosing environments with proper lighting.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Action:","type":"text","marks":[{"type":"strong"}]},{"text":" Capture images in well-lit areas to enhance clarity and quality.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Surface Consideration:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importance:","type":"text","marks":[{"type":"strong"}]},{"text":" A flat paper surface contributes to better image reception.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Action:","type":"text","marks":[{"type":"strong"}]},{"text":" Place documents on a flat, even surface before capturing to improve scan quality.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Framing within Camera Screen:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importance:","type":"text","marks":[{"type":"strong"}]},{"text":" Capture the entire page by aligning it within the frame displayed on the camera screen.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Action:","type":"text","marks":[{"type":"strong"}]},{"text":" Position the document so that it fits entirely within the visible boundaries on the camera screen.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parallel Alignment:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importance:","type":"text","marks":[{"type":"strong"}]},{"text":" Hold the device parallel to the page for optimal image capture.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Action:","type":"text","marks":[{"type":"strong"}]},{"text":" Position the device directly over the document, ensuring it is parallel to the surface.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multi-Page Scanning:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importance:","type":"text","marks":[{"type":"strong"}]},{"text":" Ability to scan invoices or documents with multiple pages in a single capture.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Action:","type":"text","marks":[{"type":"strong"}]},{"text":" Continue capturing successive pages of the document by maintaining proper alignment and framing.","type":"text"}]}]}]}]}]}]},{"type":"expand","attrs":{"title":"In 2025, a new line will be added for instant payments on the traditional orange SEPA transfer slip (also known as Überweisungsschein or Zahlschein). Do you already know how you will handle this? Will you accommodate this change?"},"content":[{"type":"paragraph","content":[{"text":"If the change involves only text without any alteration to the layout or color scheme, Gini is able to handle it without any issues. However, if there are changes to the layout or color scheme, we may need to adjust our current model once the changes are implemented.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Regarding the 2025 update, here’s what we know so far:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New Value in Line 4 of the EPC QR Code:","type":"text","marks":[{"type":"strong"}]},{"text":" We have already ensured that Ginis system can handle this addition without any problems.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bank Verification of Payment Recipient Name Matching the IBAN:","type":"text","marks":[{"type":"strong"}]},{"text":" This requirement will be handled by the banks themselves, and it won’t directly affect how we process the SEPA transfer slips.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"We are closely monitoring these updates and will make any necessary adjustments to ensure a smooth transition.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Does Gini SDK/API support HEIC format?"},"content":[{"type":"paragraph","content":[{"text":"Gini Pay API supports incoming PDF, GIF, JPEG, PNG, and TIFF documents. This is applicable if you use direct integration with the Gini API, e.g., for web upload. If the Gini Bank SDK is used, HEIC images are transformed into JPG at the SDK level, so you do not need to do anything extra to support HEIC.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Does Gini SDK have an onboarding screen where it instructs the customers how to use the invoice capture feature? Does Gini SDK keep track if the customers have already seen this screen and automatically skips it?"},"content":[{"type":"paragraph","content":[{"text":"Yes, Gini SDK shows the onboarding screens only the first time. If the user has already seen the onboarding, it will not appear anymore for this particular instance of the app. Please see more details in ","type":"text"},{"text":"our technical documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/IBSV/pages/9863895"}}]},{"text":".","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":1},"content":[{"text":"Mobile SDK","type":"text"}]},{"type":"expand","attrs":{"title":"Can the language displayed in the Banking App be customized to exclusively show German text, irrespective of the language settings on the user's device?"},"content":[{"type":"paragraph","content":[{"text":"Yes, it's possible to ensure that the Banking App displays German text regardless of the language settings on the user's device. To achieve this, you can implement a workaround by overriding the string resources for English within your app.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here's how to do it:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to the res/values-en directory in your app's resources.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the strings.xml file located in that directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the content from the Bank SDK's strings.xml and the Capture SDK's strings.xml into your app's res/values-en/strings.xml file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This will effectively force the Bank SDK to display German texts even when the device language is set to English.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"IMPORTANT:","type":"text"},{"type":"hardBreak"},{"text":"This workaround is necessary because the default behavior of the SDKs may display English text when the device language is set to English. ","type":"text"}]},{"type":"paragraph","content":[{"text":"However, please be aware that this approach is a workaround and may require manual intervention whenever the SDKs are updated. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Whenever updates occur, you'll need to ensure that the German strings are copied again into the appropriate directories to maintain consistency and prevent new texts from appearing in English.","type":"text"}]},{"type":"paragraph","content":[{"text":"We recommend monitoring updates to the SDKs and incorporating this step into your update process to ensure seamless German text display within the SpardaApp.","type":"text"}]}]}]},{"type":"expand","attrs":{"title":"Can I migrate directly from version 1 to version 3? For iOS, everything seems clear since the documentation allows upgrading from version 1 to version 3. However, on Android, we need to first upgrade from version 1 to version 2 and then from version 2 to version 3. "},"content":[{"type":"paragraph","content":[{"text":"The reason we recommend going through v2 is that v3 builds upon v2, and the migration guides are written incrementally as follows:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Migration guide from v1 to v2","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/GBSV/pages/17563801"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Migration guide from v2 to v3","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/GBSV/pages/17662257"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Our intention is to assist you in avoiding the omission of any crucial steps in the process. Although it is not obligatory to release v2, you are welcome to migrate directly from v1 to v3. Kindly follow the migration guide from v1 to v2 and then proceed to the guide from v2 to v3.","type":"text"}]}]},{"type":"expand","attrs":{"title":"What is the best practice for flash setting?"},"content":[{"type":"paragraph","content":[{"text":"We advise setting the flashlight as not active by default. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The majority of Android and iOS devices usually take a good enough picture without a flash.","type":"text"}]}]},{"type":"expand","attrs":{"title":"When does the SDK stop waiting for extraction results, and how long does the API session last?"},"content":[{"type":"paragraph","content":[{"text":"After 60 seconds, the SDK stops waiting and finishes with a timeout error. However, this does not signify the end of the Pay API session. The session remains active for 12 hours or until the SDK or Bank API Library is cleaned up, or the app is terminated.","type":"text"}]}]},{"type":"expand","attrs":{"title":"There is a descrepancy in the payment reference of an invoice via photo compared to the imported document."},"content":[{"type":"paragraph","content":[{"text":"The reason for the discrepancy between the payment references of an invoice via photo compared to the imported document is that they are going through different pipelines at the Gini backend: the photos are getting to the pre-processing and then to OCR, and the uploaded PDF files go through a PDF extractor which is a different engine from OCR. As they are two different engines, they get slightly different results. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Do we need to compress images on our side?"},"content":[{"type":"paragraph","content":[{"text":"We don’t recommend compressing the images because:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"we handle the compression on our end to ensure optimal performance;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"it can affect the accuracy of data extraction, as we don’t have control over quality anymore;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"it can deprive you and us of valuable insights, obtained from metadata that SDK stores.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"By leaving the compression to us, you can be confident that the images undergo the appropriate optimization, resulting in faster processing times and more precise data extraction.","type":"text"}]}]},{"type":"expand","attrs":{"title":"Is it possible to change the spinner?"},"content":[{"type":"paragraph","content":[{"text":"At the moment we can't change the animated icon and what we can suggest is to set a custom loading indicator via the SDK’s UI injection feature. Here are some useful links for more details:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Android: ","type":"text"},{"text":"Custom loading indicator","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/GBSV/pages/3539407/Analysis+Screen#Custom-loading-indicator"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"iOS: ","type":"text"},{"text":"Custom loading indicator","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/IBSV/pages/13959636/Analysis+Screen#Custom-loading-indicator"}}]},{"text":" ","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"Where I can find the version of the library for example GiniBankAPILibrary in the framework that you delivered us?"},"content":[{"type":"paragraph","content":[{"text":"For Android the version can be found in ","type":"text"},{"text":"BuildConfig.VERSION_NAME","type":"text","marks":[{"type":"code"}]},{"text":" in the SDK or libraries package. For example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gini Bank API Library: ","type":"text"},{"text":"net.gini.android.bank.api.BuildConfig.VERSION_NAME","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Gini Bank SDK: ","type":"text"},{"text":"net.gini.android.bank.sdk.BuildConfig.VERSION_NAME","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"For iOS the version can be found in a global String property named according to the following pattern: ","type":"text"},{"text":"Version","type":"text","marks":[{"type":"code"}]},{"text":". For example:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GiniBankAPILibraryVersion","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GiniBankSDKVersion","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"expand","attrs":{"title":"How do I access Gini Document ID from the Bank SDK?"},"content":[{"type":"paragraph","content":[{"text":"Android","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Before you start the SDK, create and configure a ","type":"text"},{"text":"GiniCaptureDefaultNetworkService","type":"text","marks":[{"type":"code"}]},{"text":" instance:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"7cf4b3c8-fc0b-4633-ad8e-422f7278a7ad"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","attrs":{"language":"kotlin"},"content":[{"text":"val networkService: GiniCaptureDefaultNetworkService = getDefaultNetworkService(\n context = this,\n clientId = myClientId,\n clientSecret = myClientSecret,\n emailDomain = myEmailDomain,\n ...\n)\n \nGiniBank.setCaptureConfiguration(\n CaptureConfiguration(\n networkService = networkService,\n ...\n )\n)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"After you receive the results, retrieve the Gini Document ID through the ","type":"text"},{"text":"analyzedGiniApiDocument","type":"text","marks":[{"type":"code"}]},{"text":" field from the same ","type":"text"},{"text":"GiniCaptureDefaultNetworkService","type":"text","marks":[{"type":"code"}]},{"text":" instance, mentioned in the previous snippet.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"74416beb-408a-4c64-a3b3-753fc0e9cbfc"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","attrs":{"language":"kotlin"},"content":[{"text":"val captureLauncher = registerForActivityResult(CaptureFlowContract()) { result: CaptureResult ->\n when (result) {\n is CaptureResult.Success -> {\n val documentId = networkService.analyzedGiniApiDocument?.id\n ...\n \n }\n ...\n }\n}","type":"text"}]}]}]}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"iOS","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The Gini Document ID is available via the ","type":"text"},{"text":"document","type":"text","marks":[{"type":"code"}]},{"text":" property of the ","type":"text"},{"text":"AnalysisResult","type":"text","marks":[{"type":"code"}]},{"text":" in the ","type":"text"},{"text":"giniCaptureAnalysisDidFinishWith()","type":"text","marks":[{"type":"code"}]},{"text":" method from ","type":"text"},{"text":"GiniCaptureResultsDelegate","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"fa33c4a1-33c0-4d11-ba7b-e38742a88e4a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","attrs":{"language":"swift"},"content":[{"text":"... : GiniCaptureResultsDelegate {\n \n func giniCaptureAnalysisDidFinishWith(result: AnalysisResult,\n sendFeedbackBlock: @escaping ([String: Extraction]) -> Void) {\n let documentId = result.document?.id\n ...\n }\n}","type":"text"}]}]}]}]}]},{"type":"expand","attrs":{"title":"Is there a way to selectively override the colors of specific GINI images, not Globally?"},"content":[{"type":"paragraph","content":[{"text":"Android","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add your own images to your app’s ","type":"text"},{"text":"res/drawable-*","type":"text","marks":[{"type":"code"}]},{"text":" folders using the image names from the SDK's UI customization guide. It is important to name the images you wish to override exactly as shown in the UI customization guide, otherwise overriding won’t work.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you use vector drawables, add them to the ","type":"text"},{"text":"drawable-anydpi","type":"text","marks":[{"type":"code"}]},{"text":" (","type":"text"},{"text":"drawable-night-anydpi","type":"text","marks":[{"type":"code"}]},{"text":" for dark mode) folders so that they also override any density-specific images.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See more information in the ","type":"text"},{"text":"UI customization guide","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/GBSV/pages/3571840"}}]},{"text":".","type":"text"}]}]}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"iOS","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an asset catalog for images called ","type":"text"},{"text":"GiniImages.xcassets","type":"text","marks":[{"type":"code"}]},{"text":" in your app.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add your own images to ","type":"text"},{"text":"GiniImages.xcassets","type":"text","marks":[{"type":"code"}]},{"text":" using the image names from the SDK's UI customization guide. It is important to name the images you wish to override exactly as shown in the UI customization guide, otherwise overriding won’t work.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"See more information in the ","type":"text"},{"text":"UI customization guide.","type":"text","marks":[{"type":"link","attrs":{"href":"https://gini.atlassian.net/wiki/spaces/IBSV/pages/14057801"}}]}]}]}]}]},{"type":"expand","attrs":{"title":"Can't access the file manager to import a PDF file from a Redmi Note Pro (Android 11) and Samsung Galaxy Z Flip 3 (Android 12). Only importing photos is possible. On a Google Pixel 5 (Android 11 + Android 12) can't import either."},"content":[{"type":"paragraph","content":[{"text":"For Android 11 and later Apps it is required to declare in the Android Manifest what kind of apps they are querying.","type":"text"}]},{"type":"paragraph","content":[{"text":"Our SDK queries for apps that allow opening images and PDF files. Enable uploading images and PDF files and add the following element to your app’s AndroidManifest.xml:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"5cb4852c-132c-433c-9682-4d406cfc821b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"iOS Bank SDK v.1.x","type":"text"}]},{"type":"expand","attrs":{"title":"Is there a way to selectively override the colors of specific GINI images, not Globally? (iOS)"},"content":[{"type":"paragraph","content":[{"text":"Here is how can override the colors of specific Gini images on iOS:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an image asset GiniImages.xcassets in your app.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Override the default name by adding a tinted image in ‘GiniImages.xcassets’.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The image name can be found here ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/gini/gini-mobile-ios/tree/GiniBankSDK%3B1.8.0/BankSDK/GiniBankSDK/Sources/GiniBankSDK/Resources/GiniImages.xcassets"}},{"text":" ","type":"text"}]}]}]}]},{"type":"expand","attrs":{"title":"Can't find GiniBankSDKVersion for GiniBankSDK. "},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":441,"id":"8f9ddd24-4c6f-4b1b-9eec-ca2213d5ad7a","collection":"contentId-51282724","type":"file","height":83}}]},{"type":"paragraph","content":[{"text":"If you use XCFrameworks 3 frameworks may have different versions: ","type":"text"}]},{"type":"paragraph","content":[{"text":"GiniBankAPILibraryVersion should show GiniBankAPILibrary version. ","type":"text"}]},{"type":"paragraph","content":[{"text":"GiniCaptureSDKVersion should show GiniCaptureSDK version.","type":"text"}]},{"type":"paragraph","content":[{"text":"GiniBankSDK 1.6.0 uses ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/gini/capture-sdk-ios/releases/tag/1.6.0"}},{"text":" and ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://github.com/gini/bank-api-library-ios/releases/tag/1.2.0"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you use Swift Package Manager(SPM) each package has a file (*NameSDK*)Version.swift where you can find a current version. For example, see ","type":"text"},{"text":"GiniBankSDKVersion.swift","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"expand","attrs":{"title":"How to send the payment purpose and the payment reference fields to Gini?"},"content":[{"type":"paragraph","content":[{"text":"iOS implementation would look like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"dictionary[\"paymentPurpose\"] = state.description (=Verwendungszweck)\ndictionary[\"paymentReference\"] = state.endToEndId (=Referenz)","type":"text"}]},{"type":"codeBlock","content":[{"text":"label paymentPurpose = Verwendungszweck (max 140 char)\nlabel paymentReference = Kundenreferenz = End zu End Referenz (max 35 char)","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Pay API","type":"text"}]},{"type":"expand","attrs":{"title":"There is information for SDK migrations (ios, android, xamarin) but I didn’t see anything about REST API. Could you verify that there are no changes? We use this endpoint https://api.gini.net/documents and I couldn’t find this one in your dev portal."},"content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/PA1"}},{"text":" ","type":"text"}]}]},{"type":"expand","attrs":{"title":"We do not see \"Verwendungszweck\". We assume \"purpose\" and \"payments reference\" can be \"Verwendungszweck\", but we use \"purpose\". Which one is the correct one and why?"},"content":[{"type":"paragraph","content":[{"text":"We differentiate between paymentPurpose and paymentReferences on remittance slips only (Verwendungszweck vs. Zahlungsreferenz). On invoices, you only find the paymentPurpose field. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The reason is that many vendors and QR code creators do not follow the rules exactly and put payment purpose information into the line where the reference should be. Therefore, Gini decided to put everything in the purpose line.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more details, see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/PA1/pages/36831473"}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Where can I find the information about Document Status?"},"content":[{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/PA1"}},{"text":" ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Why does the request fails and we get statuscode 401?"},"content":[{"type":"paragraph","content":[{"text":"It might be a firewall topic on your side. Check if the ","type":"text"},{"text":"X-User-Identifier","type":"text","marks":[{"type":"strong"}]},{"text":" is allowed for ","type":"text"},{"text":"pay-api.gini.net","type":"text","marks":[{"type":"link","attrs":{"href":"http://pay-api.gini.net/"}}]},{"text":". If it is allowed only for ","type":"text"},{"text":"api.gini.net","type":"text","marks":[{"type":"link","attrs":{"href":"https://api.gini.net/"}}]},{"text":", this can be an issue. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"Is is possible to remove \"list all documents\"?"},"content":[{"type":"paragraph","content":[{"text":"We can not remove it as it is still valuable for our partners. This API call is a part of the general API functionality and our customers use it, for example, for the extended turnover list where they attach invoices and other document turnovers. This lets them see which documents belong to a specific user. ","type":"text"}]}]},{"type":"expand","attrs":{"title":"What data is exchanged between our app and Gini backend system?"},"content":[{"type":"paragraph","content":[{"text":"Gini provides a system to extract payment information from invoices, reminders, and remittance slips with QR codes and without QR codes. The system can handle photos made with Android- or iOS-based devices as well as PDF files uploaded from a web application.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Gini backend API supports incoming PDF, GIF, JPEG, PNG, and TIFF documents from the app and returns an extraction back. ","type":"text"}]},{"type":"paragraph","content":[{"text":"An extraction contains an entity that describes a general semantic type of the extraction (e.g. an IBAN, a BIC, an amount). The entity also determines the format of the value containing text information. For more details, see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://gini.atlassian.net/wiki/spaces/PA1/pages/31621153"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Check out the simplified data flow diagram.","type":"text"}]},{"type":"paragraph"}]},{"type":"expand","attrs":{"title":"Can you send us the GINI certificate? We need it officially from you today in order to continue our work."},"content":[{"type":"paragraph","content":[{"text":"As our endpoints are public HTTPS endpoints, you can always get the certificate from ","type":"text"},{"text":"https://pay-api.gini.net","type":"text","marks":[{"type":"link","attrs":{"href":"https://pay-api.gini.net/"}}]},{"text":" (it is a wildcard certificate for *.","type":"text"},{"text":"gini.net","type":"text","marks":[{"type":"link","attrs":{"href":"http://gini.net/"}}]},{"text":"). When you open this URL in a browser, you can get the public key quite easily by clicking on the lock symbol, for example, in Chrome:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":722,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1798,"type":"external","url":"https://attachment.freshdesk.com/inline/attachment?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZCI6MjUwMzAzNDkxMTcsImRvbWFpbiI6ImdpbmlzLmZyZXNoZGVzay5jb20iLCJhY2NvdW50X2lkIjo1NTUzNDh9.4PWKMOLTJ563PwwyAuApgllM-krwGSemGtm_P7n5hrY","height":1056},"marks":[{"type":"border","attrs":{"size":2,"color":"#091e4224"}}]}]}]},{"type":"expand","attrs":{"title":"Is there enough time to prepare when new certificates re introduced/available?"},"content":[{"type":"paragraph","content":[{"text":"We rotate our certificate on a yearly basis and provide the new certificate about 2 months before it expires (+ an API-URL where the new certificate can be tested). In general, we try not to change the public key of the certificate (this is the part that is usually pinned) so that the customer doesn’t have to do anything.","type":"text"}]}]}],"version":1}