[go: up one dir, main page]

Full integrated (SDK)

Accepting payments inside your own application.


For a more "native" experience we also offer an embedded SDK. If you implement this SDK you will be able to accept payments inside your own App. However, this is an extended integration approach, the significantly easier way to get started is to utilize our same device inject which requires little to no setup.

SDK status:

PlatformSupport StatusDocs
iOS - Tap to Pay on iPhoneEnabled for select partnersGithub
Android - SoftposEnabled for select partnersGithub
Sunmi - HardposEnabled for select partnersGithub
PAX - HardposEnabled for select partnersGithub
React nativeEnabled for select partnersGithub

How to gain access

⚠️

Make sure you have integrated the PAY.POS app with inject before you can apply for SDK. Eligibility is based on the amount of transactions done via inject flow

In order to gain access to our integrated SDK you must submit an inquiry to [email protected] and mention the following data:

FieldValue
Organization Name:
Current PAY.POS app version
Flavor:Native or React Native
PlatformAndroid and/or iOS
App Identifier iOS:
App identifier Android:

Tap to Pay on iPhone

For Tap to Pay on iPhone (iOS) you need to complete the following form for your app. You should see a form from Apple requiring you to fill in some information about your organization and what you need access to.

Requirements:

  • iOS 18 or higher
  • iPhone only (iPad not supported)
  • Your project supports CocoaPods or swift package manager
  • Make sure you have contacted PayNL support for an integrationId (required for initSDK)
  • Make sure you have access to the Tap to Pay on iPhone entitlement. You can request this via this form

Android SoftPos

Requirements:

  • Android v8.0 or higher (minSDK 26)
    • Android security patch is not older than 2 years
  • Device support NFC (and is enabled)
  • Android GMS (Google Mobile Services) support refers to devices that come with a pre-installed suite of Google applications and APIs, enabling access to Google services like the Play Store, Maps, and Gmail, along with push notifications, security features, and seamless user account synchronization. GMS ensures a familiar and feature-rich Android experience out-of-the-box, providing consistent functionality and a wider app selection through the Google Play Store.
  • Make sure you have contacted PayNL support for an integrationId (required for initSDK)
  • Make sure you have the gradle credentials from PayNL support
  • Make sure you have a personal access token on Github with read:packages scope
🚧

A hardPOS device (like the Sunmi P series or PAX) is not supported via this SDK

Sunmi HardPos

Requirements:

  • Only Sunmi P-devices are supported: device list
  • Make sure your P-device has the following software requirements:
    • SunmiPayHardwareService version 3.3.0 or higher
    • Remote Key Injection (RKI) app version 1.3.32 or higher
      • The RKI app must also have a certificate
    • if one or both are too lower, please contact Sunmi support
  • Make sure you have contacted PayNL support for an integrationId (required for initSDK)
  • Make sure you have a personal access token on Github with read:packages scope

PAX HardPos

Requirements:

  • Only PAX Paydroid devices are supported
  • Make sure your PAX device is enlisted on PAYNL's PAX portal
  • Make sure you have contacted PayNL support for an integrationId (required for initSDK)
  • Make sure you have a personal access token on Github with read:packages scope

React Native

Requirements:

Both old & new architectures are supported.

  • Other requirements are dependent on the platform itself
  • Switching between (Android) softpos & hardpos is possible during build time - docs