React Native SDK overview

react-native-lina-pay-sdk brings the same Open Finance payment flow as the Web SDK to a React Native app: list participants, open a payment consent, and finish the payment — plus device enrollment with FIDO2/Passkeys for redirectless, biometric-authorized payments.

Requirements

Install

npm install react-native-lina-pay-sdk

yarn add react-native-lina-pay-sdk

Configure the environment

The SDK is pointed at the homologation (HML) environment by default. Call configure once at app startup to target production:

import LinaPaySdk from 'react-native-lina-pay-sdk'

LinaPaySdk.configure({
iamBaseUrl: 'https://iam.prod.linaob.com.br',
apiBaseUrl: 'https://embedded-payment-manager.prod.linaob.com.br',
})

Default (HML) URLs, shown for reference:

{
iamBaseUrl: 'https://iam.hml.linaob.com.br',
apiBaseUrl: 'https://embedded-payment-manager.hml.linaob.com.br',
}

Authentication

Authentication is automatic: the SDK exchanges your credentials for an OAuth2 access token, caches it, and refreshes it about 5 minutes before it expires. You never call an auth endpoint directly.

What it covers

• Payment flow — list participants, open a consent, and finish the payment after the bank redirects back.
• Enrollments — register a payer's device with a FIDO2/Passkey.
• Pay with an enrollment — redirectless, biometric-authorized payment.
• Error handling — LinaPayError.

Next steps

• Payment flow — the redirect-based journey, step by step.
• Enrollments — link a device for redirectless payments.