💳 cielo-smartpos-expo-module

Expo module library to simplify integration with Cielo SmartPOS

🚀 Installation

``bash
npm i cielo-smartpos-expo-module
`

Usage

`typescript
import {
doAsyncPayment,
doAsyncVoidPayment,
doAsyncPrintText,
doAsyncPrintBitmap,
getSerialNumber,
CieloSmartposExpoModule,
} from "cielo-smartpos-expo-module";
`

$3

`xml



















android:name=".MainApplication"
android:label="@string/app_name"
android:icon="@mipmap/ic_launcher"
android:roundIcon="@mipmap/ic_launcher_round"
android:allowBackup="true"
android:theme="@style/AppTheme"
android:supportsRtl="true"
android:enableOnBackInvokedCallback="false"
android:requestLegacyExternalStorage="true">





android:name=".MainActivity"
android:configChanges="keyboard|keyboardHidden|orientation|screenSize|screenLayout|uiMode"
android:launchMode="singleTask"
android:windowSoftInputMode="adjustResize"
android:theme="@style/Theme.App.SplashScreen"
android:exported="true"
android:screenOrientation="portrait">


































`

$3

`xml

cielo-smartpos-expo-module-example
contain
false


cielo-smartpos-expo-module


payment
payment-reversal
print

`

⚠️ Important rule about the host name: it must match the screen route (Expo Router)

The host defined in each intent filter must match the exact route of the screen that will receive the deep link callback.

Examples:

app/index.tsx → host must be "index"

app/payment.tsx → host must be "payment"

app/sell/finish.tsx → host must be "finish"

So, for example:

✔ If your callback should return to app/index.tsx:

`xml

`

✔ For a screen like app/payment.tsx:
`xml

`

This is mandatory, because SmartPOS always returns in the format:
`ruby
://
``

And the host must match your route exactly for Expo Router to open the correct screen.


📁 You can check all function examples in example/App.tsx

📚 API Reference

$3

doAsyncPayment:
Starts a payment operation.

doAsyncVoidPayment:
Performs a void (cancellation) of a previous payment.

doAsyncPrintText:
Starts a text print

doAsyncPrintBitmap:
Starts a image print

getSerialNumber:
Returns the SmartPOS device serial number.

CieloSmartposExpoModule:
Default exported module object (contains methods registration helpers).

📘 Important notice (Cielo documentation)

For full details about how SmartPOS deep link integration works, developers must consult the official Cielo documentation:

👉 Cielo SmartPOS Deep Link Integration

This library does not replace the official flow; it only simplifies the communication layer.

Contributing

🤝 Pull requests are welcome. For major changes, please open an issue first
to discuss what you would like to change.

📄 License

MIT