@onramper/onramper-react-native 1.1.1 → 1.2.1

package/lib/typescript/module/src/index.d.ts

@@ -4,6 +4,6 @@ export { OnramperCheckoutButtonView } from './OnramperCheckoutButtonView.js';
 export type { OnramperCheckoutButtonViewProps } from './OnramperCheckoutButtonView.js';
 export { OnramperError } from './errors.js';
 export type { OnramperErrorCode, OnramperErrorPayload } from './errors.js';
-export type { CheckoutButtonStyle, CheckoutFinalizeResponse, CheckoutRequest, CheckoutPaymentType, CheckoutRequirement, HeadlessCheckoutData, OnramperConfiguration, OnramperEnvironment, OnramperLogLevel, OnramperState, OnramperTheme, QuoteResponse, RenderType, ReverificationField, SessionCredentials, ToSItem, TransactionType, UserInfoField, UserInfoFieldType, WalletInfo, } from './types.js';
+export type { CheckoutButtonStyle, CheckoutFinalizeResponse, CheckoutRequest, CheckoutPaymentType, CheckoutRequirement, HeadlessCheckoutData, OnramperConfiguration, OnramperEnvironment, OnramperLogLevel, OnramperState, OnramperTheme, OnramperUserPrefill, QuoteResponse, RenderType, ReverificationField, SessionCredentials, ToSItem, TransactionType, UserInfoField, UserInfoFieldType, WalletInfo, } from './types.js';
 export type { CheckoutEvent, EventName, EventPayload } from './events.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,YAAY,EAAE,6BAA6B,EAAE,MAAM,qBAAkB,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAA8B,CAAC;AAC1E,YAAY,EAAE,+BAA+B,EAAE,MAAM,iCAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAU,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAU,CAAC;AACxE,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAS,CAAC;AACjB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,YAAY,EAAE,6BAA6B,EAAE,MAAM,qBAAkB,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAA8B,CAAC;AAC1E,YAAY,EAAE,+BAA+B,EAAE,MAAM,iCAA8B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAU,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAU,CAAC;AACxE,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAS,CAAC;AACjB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAU,CAAC"}

package/lib/typescript/module/src/specs/OnramperNitro.nitro.d.ts

@@ -30,10 +30,11 @@ export interface OnramperNitro extends HybridObject<{
     initialize(sessionId: string, sessionToken: string): Promise<void>;
     reset(): Promise<void>;
     signOut(): Promise<void>;
-    getCheckoutRequirements(requestJson: string, styleJson: string): Promise<PreparedIntentResult>;
+    getCheckoutRequirements(requestJson: string, prefillJson: string, styleJson: string): Promise<PreparedIntentResult>;
     cancelPreparedIntent(intentHandle: string): Promise<void>;
     setStateListener(onState: (stateJson: string) => void): void;
     setEventListener(onEvent: (eventJson: string) => void): void;
+    setTransactionIdListener(onTransactionId: (transactionId: string | undefined) => void): void;
     setSessionExpirationHandler(handler: () => Promise<NitroSessionCredentials>): void;
 }
 //# sourceMappingURL=OnramperNitro.nitro.d.ts.map

package/lib/typescript/module/src/specs/OnramperNitro.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OnramperNitro.nitro.d.ts","sourceRoot":"","sources":["../../../../../src/specs/OnramperNitro.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;IACnE,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAMzB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/F,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG1D,gBAAgB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7D,gBAAgB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAI7D,2BAA2B,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC;CAKpF"}
+{"version":3,"file":"OnramperNitro.nitro.d.ts","sourceRoot":"","sources":["../../../../../src/specs/OnramperNitro.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAc,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAAC;IACnE,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IASzB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACpH,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG1D,gBAAgB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC7D,gBAAgB,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAE7D,wBAAwB,CAAC,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,GAAG,IAAI,CAAC;IAI7F,2BAA2B,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAAC;CAKpF"}

package/lib/typescript/module/src/types.d.ts

@@ -49,6 +49,13 @@ export interface QuoteResponse {
     transactionFee: number;
     recommendations?: string[];
 }
+export interface OnramperUserPrefill {
+    email?: string;
+    firstName?: string;
+    lastName?: string;
+    /** E.164 format, e.g. `+3712345678`. Always a candidate — the user still verifies it. */
+    phoneNumber?: string;
+}
 export interface CheckoutButtonStyle {
     backgroundColor?: string;
     foregroundColor?: string;
@@ -63,6 +70,8 @@ export interface HeadlessCheckoutData {
 }
 export interface CheckoutFinalizeResponse {
     headlessCheckoutId: string;
+    /** Durable Onramper transaction identifier for support, reconciliation, and status lookups. */
+    onramperTransactionId: string;
     headlessCheckoutData: HeadlessCheckoutData;
 }
 export type CheckoutRequirement = {

package/lib/typescript/module/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/types.ts"],"names":[],"mappings":"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"}

package/nitrogen/generated/ios/OnramperReactNative-Swift-Cxx-Bridge.cpp

@@ -63,6 +63,14 @@ namespace margelo::nitro::onramper::bridge::swift {
     };
   }
   
+  // pragma MARK: std::function<void(const std::optional<std::string>& /* transactionId */)>
+  Func_void_std__optional_std__string_ create_Func_void_std__optional_std__string_(void* NON_NULL swiftClosureWrapper) noexcept {
+    auto swiftClosure = OnramperReactNative::Func_void_std__optional_std__string_::fromUnsafe(swiftClosureWrapper);
+    return [swiftClosure = std::move(swiftClosure)](const std::optional<std::string>& transactionId) mutable -> void {
+      swiftClosure.call(transactionId);
+    };
+  }
+  
   // pragma MARK: std::function<void(const NitroSessionCredentials& /* result */)>
   Func_void_NitroSessionCredentials create_Func_void_NitroSessionCredentials(void* NON_NULL swiftClosureWrapper) noexcept {
     auto swiftClosure = OnramperReactNative::Func_void_NitroSessionCredentials::fromUnsafe(swiftClosureWrapper);

package/nitrogen/generated/ios/OnramperReactNative-Swift-Cxx-Bridge.hpp

@@ -34,6 +34,7 @@ namespace OnramperReactNative { class HybridOnramperNitroSpec_cxx; }
 #include <exception>
 #include <functional>
 #include <memory>
+#include <optional>
 #include <string>
 
 /**
@@ -166,6 +167,43 @@ namespace margelo::nitro::onramper::bridge::swift {
     return Func_void_std__string_Wrapper(std::move(value));
   }
   
+  // pragma MARK: std::optional<std::string>
+  /**
+   * Specialized version of `std::optional<std::string>`.
+   */
+  using std__optional_std__string_ = std::optional<std::string>;
+  inline std::optional<std::string> create_std__optional_std__string_(const std::string& value) noexcept {
+    return std::optional<std::string>(value);
+  }
+  inline bool has_value_std__optional_std__string_(const std::optional<std::string>& optional) noexcept {
+    return optional.has_value();
+  }
+  inline std::string get_std__optional_std__string_(const std::optional<std::string>& optional) noexcept {
+    return optional.value();
+  }
+  
+  // pragma MARK: std::function<void(const std::optional<std::string>& /* transactionId */)>
+  /**
+   * Specialized version of `std::function<void(const std::optional<std::string>&)>`.
+   */
+  using Func_void_std__optional_std__string_ = std::function<void(const std::optional<std::string>& /* transactionId */)>;
+  /**
+   * Wrapper class for a `std::function<void(const std::optional<std::string>& / * transactionId * /)>`, this can be used from Swift.
+   */
+  class Func_void_std__optional_std__string__Wrapper final {
+  public:
+    explicit Func_void_std__optional_std__string__Wrapper(std::function<void(const std::optional<std::string>& /* transactionId */)>&& func): _function(std::make_unique<std::function<void(const std::optional<std::string>& /* transactionId */)>>(std::move(func))) {}
+    inline void call(std::optional<std::string> transactionId) const noexcept {
+      _function->operator()(transactionId);
+    }
+  private:
+    std::unique_ptr<std::function<void(const std::optional<std::string>& /* transactionId */)>> _function;
+  } SWIFT_NONCOPYABLE;
+  Func_void_std__optional_std__string_ create_Func_void_std__optional_std__string_(void* NON_NULL swiftClosureWrapper) noexcept;
+  inline Func_void_std__optional_std__string__Wrapper wrap_Func_void_std__optional_std__string_(Func_void_std__optional_std__string_ value) noexcept {
+    return Func_void_std__optional_std__string__Wrapper(std::move(value));
+  }
+  
   // pragma MARK: std::shared_ptr<Promise<NitroSessionCredentials>>
   /**
    * Specialized version of `std::shared_ptr<Promise<NitroSessionCredentials>>`.

package/nitrogen/generated/ios/OnramperReactNative-Swift-Cxx-Umbrella.hpp

@@ -30,6 +30,7 @@ namespace margelo::nitro::onramper { struct PreparedIntentResult; }
 #include <exception>
 #include <functional>
 #include <memory>
+#include <optional>
 #include <string>
 
 // C++ helpers for Swift

package/nitrogen/generated/ios/c++/HybridOnramperNitroSpecSwift.hpp

@@ -24,6 +24,7 @@ namespace margelo::nitro::onramper { struct NitroSessionCredentials; }
 #include <string>
 #include "PreparedIntentResult.hpp"
 #include <functional>
+#include <optional>
 #include "NitroSessionCredentials.hpp"
 
 #include "OnramperReactNative-Swift-Cxx-Umbrella.hpp"
@@ -108,8 +109,8 @@ namespace margelo::nitro::onramper {
       auto __value = std::move(__result.value());
       return __value;
     }
-    inline std::shared_ptr<Promise<PreparedIntentResult>> getCheckoutRequirements(const std::string& requestJson, const std::string& styleJson) override {
-      auto __result = _swiftPart.getCheckoutRequirements(requestJson, styleJson);
+    inline std::shared_ptr<Promise<PreparedIntentResult>> getCheckoutRequirements(const std::string& requestJson, const std::string& prefillJson, const std::string& styleJson) override {
+      auto __result = _swiftPart.getCheckoutRequirements(requestJson, prefillJson, styleJson);
       if (__result.hasError()) [[unlikely]] {
         std::rethrow_exception(__result.error());
       }
@@ -136,6 +137,12 @@ namespace margelo::nitro::onramper {
         std::rethrow_exception(__result.error());
       }
     }
+    inline void setTransactionIdListener(const std::function<void(const std::optional<std::string>& /* transactionId */)>& onTransactionId) override {
+      auto __result = _swiftPart.setTransactionIdListener(onTransactionId);
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+    }
     inline void setSessionExpirationHandler(const std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<NitroSessionCredentials>>>>()>& handler) override {
       auto __result = _swiftPart.setSessionExpirationHandler(handler);
       if (__result.hasError()) [[unlikely]] {

package/nitrogen/generated/ios/swift/Func_void_std__optional_std__string_.swift

@@ -0,0 +1,53 @@
+///
+/// Func_void_std__optional_std__string_.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Wraps a Swift `(_ transactionId: String?) -> Void` as a class.
+ * This class can be used from C++, e.g. to wrap the Swift closure as a `std::function`.
+ */
+public final class Func_void_std__optional_std__string_ {
+  public typealias bridge = margelo.nitro.onramper.bridge.swift
+
+  private let closure: (_ transactionId: String?) -> Void
+
+  public init(_ closure: @escaping (_ transactionId: String?) -> Void) {
+    self.closure = closure
+  }
+
+  @inline(__always)
+  public func call(transactionId: bridge.std__optional_std__string_) -> Void {
+    self.closure({ () -> String? in
+      if bridge.has_value_std__optional_std__string_(transactionId) {
+        let __unwrapped = bridge.get_std__optional_std__string_(transactionId)
+        return String(__unwrapped)
+      } else {
+        return nil
+      }
+    }())
+  }
+
+  /**
+   * Casts this instance to a retained unsafe raw pointer.
+   * This acquires one additional strong reference on the object!
+   */
+  @inline(__always)
+  public func toUnsafe() -> UnsafeMutableRawPointer {
+    return Unmanaged.passRetained(self).toOpaque()
+  }
+
+  /**
+   * Casts an unsafe pointer to a `Func_void_std__optional_std__string_`.
+   * The pointer has to be a retained opaque `Unmanaged<Func_void_std__optional_std__string_>`.
+   * This removes one strong reference from the object!
+   */
+  @inline(__always)
+  public static func fromUnsafe(_ pointer: UnsafeMutableRawPointer) -> Func_void_std__optional_std__string_ {
+    return Unmanaged<Func_void_std__optional_std__string_>.fromOpaque(pointer).takeRetainedValue()
+  }
+}

package/nitrogen/generated/ios/swift/HybridOnramperNitroSpec.swift

@@ -17,10 +17,11 @@ public protocol HybridOnramperNitroSpec_protocol: HybridObject {
   func initialize(sessionId: String, sessionToken: String) throws -> Promise<Void>
   func reset() throws -> Promise<Void>
   func signOut() throws -> Promise<Void>
-  func getCheckoutRequirements(requestJson: String, styleJson: String) throws -> Promise<PreparedIntentResult>
+  func getCheckoutRequirements(requestJson: String, prefillJson: String, styleJson: String) throws -> Promise<PreparedIntentResult>
   func cancelPreparedIntent(intentHandle: String) throws -> Promise<Void>
   func setStateListener(onState: @escaping (_ stateJson: String) -> Void) throws -> Void
   func setEventListener(onEvent: @escaping (_ eventJson: String) -> Void) throws -> Void
+  func setTransactionIdListener(onTransactionId: @escaping (_ transactionId: String?) -> Void) throws -> Void
   func setSessionExpirationHandler(handler: @escaping () -> Promise<Promise<NitroSessionCredentials>>) throws -> Void
 }
 

package/nitrogen/generated/ios/swift/HybridOnramperNitroSpec_cxx.swift

@@ -201,9 +201,9 @@ open class HybridOnramperNitroSpec_cxx {
   }
   
   @inline(__always)
-  public final func getCheckoutRequirements(requestJson: std.string, styleJson: std.string) -> bridge.Result_std__shared_ptr_Promise_PreparedIntentResult___ {
+  public final func getCheckoutRequirements(requestJson: std.string, prefillJson: std.string, styleJson: std.string) -> bridge.Result_std__shared_ptr_Promise_PreparedIntentResult___ {
     do {
-      let __result = try self.__implementation.getCheckoutRequirements(requestJson: String(requestJson), styleJson: String(styleJson))
+      let __result = try self.__implementation.getCheckoutRequirements(requestJson: String(requestJson), prefillJson: String(prefillJson), styleJson: String(styleJson))
       let __resultCpp = { () -> bridge.std__shared_ptr_Promise_PreparedIntentResult__ in
         let __promise = bridge.create_std__shared_ptr_Promise_PreparedIntentResult__()
         let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_PreparedIntentResult__(__promise)
@@ -270,6 +270,28 @@ open class HybridOnramperNitroSpec_cxx {
     }
   }
   
+  @inline(__always)
+  public final func setTransactionIdListener(onTransactionId: bridge.Func_void_std__optional_std__string_) -> bridge.Result_void_ {
+    do {
+      try self.__implementation.setTransactionIdListener(onTransactionId: { () -> (String?) -> Void in
+        let __wrappedFunction = bridge.wrap_Func_void_std__optional_std__string_(onTransactionId)
+        return { (__transactionId: String?) -> Void in
+          __wrappedFunction.call({ () -> bridge.std__optional_std__string_ in
+            if let __unwrappedValue = __transactionId {
+              return bridge.create_std__optional_std__string_(std.string(__unwrappedValue))
+            } else {
+              return .init()
+            }
+          }())
+        }
+      }())
+      return bridge.create_Result_void_()
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_void_(__exceptionPtr)
+    }
+  }
+  
   @inline(__always)
   public final func setSessionExpirationHandler(handler: bridge.Func_std__shared_ptr_Promise_std__shared_ptr_Promise_NitroSessionCredentials____) -> bridge.Result_void_ {
     do {

package/nitrogen/generated/shared/c++/HybridOnramperNitroSpec.cpp

@@ -22,6 +22,7 @@ namespace margelo::nitro::onramper {
       prototype.registerHybridMethod("cancelPreparedIntent", &HybridOnramperNitroSpec::cancelPreparedIntent);
       prototype.registerHybridMethod("setStateListener", &HybridOnramperNitroSpec::setStateListener);
       prototype.registerHybridMethod("setEventListener", &HybridOnramperNitroSpec::setEventListener);
+      prototype.registerHybridMethod("setTransactionIdListener", &HybridOnramperNitroSpec::setTransactionIdListener);
       prototype.registerHybridMethod("setSessionExpirationHandler", &HybridOnramperNitroSpec::setSessionExpirationHandler);
     });
   }

package/nitrogen/generated/shared/c++/HybridOnramperNitroSpec.hpp

@@ -25,6 +25,7 @@ namespace margelo::nitro::onramper { struct NitroSessionCredentials; }
 #include <string>
 #include "PreparedIntentResult.hpp"
 #include <functional>
+#include <optional>
 #include "NitroSessionCredentials.hpp"
 
 namespace margelo::nitro::onramper {
@@ -62,10 +63,11 @@ namespace margelo::nitro::onramper {
       virtual std::shared_ptr<Promise<void>> initialize(const std::string& sessionId, const std::string& sessionToken) = 0;
       virtual std::shared_ptr<Promise<void>> reset() = 0;
       virtual std::shared_ptr<Promise<void>> signOut() = 0;
-      virtual std::shared_ptr<Promise<PreparedIntentResult>> getCheckoutRequirements(const std::string& requestJson, const std::string& styleJson) = 0;
+      virtual std::shared_ptr<Promise<PreparedIntentResult>> getCheckoutRequirements(const std::string& requestJson, const std::string& prefillJson, const std::string& styleJson) = 0;
       virtual std::shared_ptr<Promise<void>> cancelPreparedIntent(const std::string& intentHandle) = 0;
       virtual void setStateListener(const std::function<void(const std::string& /* stateJson */)>& onState) = 0;
       virtual void setEventListener(const std::function<void(const std::string& /* eventJson */)>& onEvent) = 0;
+      virtual void setTransactionIdListener(const std::function<void(const std::optional<std::string>& /* transactionId */)>& onTransactionId) = 0;
       virtual void setSessionExpirationHandler(const std::function<std::shared_ptr<Promise<std::shared_ptr<Promise<NitroSessionCredentials>>>>()>& handler) = 0;
 
     protected:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onramper/onramper-react-native",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "React Native wrapper for the Onramper iOS SDK",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -64,7 +64,7 @@
   "license": "Apache-2.0",
   "homepage": "https://github.com/onramper/onramper-react-native#readme",
   "onramperSDK": {
-    "checksum": "88235fa50561422ba3276f8008ff0a2229cff760f75f36f3f424ff5f26e2b2e2"
+    "checksum": "305cca364bb24bb5ec964488e1dc815a9a63c734a989482080cbc02993ec7f6b"
   },
   "peerDependencies": {
     "react": ">=19.0.0",

package/src/OnramperClient.ts

@@ -9,6 +9,7 @@ import type {
   CheckoutRequest,
   OnramperConfiguration,
   OnramperState,
+  OnramperUserPrefill,
   QuoteResponse,
   SessionCredentials,
 } from './types';
@@ -29,12 +30,14 @@ export interface GetCheckoutRequirementsResult {
 export class OnramperClient {
   state: OnramperState = { kind: 'idle' };
   lastError: OnramperError | null = null;
+  currentTransactionId: string | null = null;
 
   // Each client owns its own native instance (and thus its own SDK client).
   private readonly native = createOnramperNative();
 
   private readonly stateListeners = new Set<(state: OnramperState) => void>();
   private readonly eventListeners = new Set<(event: CheckoutEvent) => void>();
+  private readonly transactionIdListeners = new Set<(transactionId: string | null) => void>();
 
   // Resolved when the constructor-issued configure() completes. Public methods
   // that need the native client await this first.
@@ -49,12 +52,23 @@ export class OnramperClient {
       for (const fn of this.stateListeners) fn(s);
     });
 
-    // Single native checkout-event callback → fan out to listeners.
+    // Single native checkout-event callback → keep the transaction ID mirror
+    // synchronized at finalization, then fan out to checkout listeners.
     this.native.setEventListener((json) => {
       const e = JSON.parse(json) as CheckoutEvent;
+      if (e.type === 'checkoutFinalized') {
+        this.updateCurrentTransactionId(e.response.onramperTransactionId);
+      }
       for (const fn of this.eventListeners) fn(e);
     });
 
+    this.native.setTransactionIdListener((transactionId) => {
+      // The SDK transiently publishes nil while re-preparing after the payment
+      // sheet is dismissed. The finalized transaction ID remains durable across
+      // that attempt change; only explicit reset()/signOut() clear the JS mirror.
+      if (transactionId !== undefined) this.updateCurrentTransactionId(transactionId);
+    });
+
     // The SDK calls this when its session expires; return fresh credentials.
     // Nitro stores the async callback natively and awaits it directly — no
     // event round-trip needed.
@@ -81,6 +95,19 @@ export class OnramperClient {
     this.configured.catch(() => undefined);
   }
 
+  private updateCurrentTransactionId(next: string | null): void {
+    if (next === this.currentTransactionId) return;
+
+    this.currentTransactionId = next;
+    for (const fn of [...this.transactionIdListeners]) {
+      try {
+        fn(next);
+      } catch (error: unknown) {
+        console.error('Onramper transaction ID listener threw:', error);
+      }
+    }
+  }
+
   async initialize(creds: SessionCredentials): Promise<void> {
     try {
       await this.configured;
@@ -94,6 +121,7 @@ export class OnramperClient {
     try {
       await this.configured;
       await this.native.reset();
+      this.updateCurrentTransactionId(null);
     } catch (e: unknown) {
       throw OnramperError.from(e);
     }
@@ -109,6 +137,7 @@ export class OnramperClient {
     try {
       await this.configured;
       await this.native.signOut();
+      this.updateCurrentTransactionId(null);
     } catch (e: unknown) {
       throw OnramperError.from(e);
     }
@@ -118,14 +147,29 @@ export class OnramperClient {
    * Fetches checkout requirements + quote and returns a native checkout button
    * to render plus the quote. The button handles login / finalize / webview
    * internally; outcomes surface via the event stream (`addEventListener`).
+   *
+   * Pass `prefill` to pre-populate the OnramperID sign-in and additional-info
+   * screens with values you already know about the user. It is best-effort and
+   * never blocks sign-in — there is no error to handle. Note the caveat on
+   * `OnramperUserPrefill.email` before supplying it.
+   *
+   * `prefill` trails `buttonStyle` here, unlike the Swift
+   * `getCheckoutRequirements(_:prefill:buttonStyle:)` where argument labels make
+   * the middle position free: appending it keeps every existing JS call site
+   * working unchanged.
    */
   async getCheckoutRequirements(
     request: CheckoutRequest,
     buttonStyle: CheckoutButtonStyle = {},
+    prefill: OnramperUserPrefill = {},
   ): Promise<GetCheckoutRequirementsResult> {
     try {
       await this.configured;
-      const result = await this.native.getCheckoutRequirements(JSON.stringify(request), JSON.stringify(buttonStyle));
+      const result = await this.native.getCheckoutRequirements(
+        JSON.stringify(request),
+        JSON.stringify(prefill),
+        JSON.stringify(buttonStyle),
+      );
       const quote = JSON.parse(result.quoteJson) as QuoteResponse;
       const button = createElement(OnramperCheckoutButtonView, {
         intentHandle: result.intentHandle,
@@ -150,6 +194,14 @@ export class OnramperClient {
     };
   }
 
+  /** Subscribe to the durable Onramper transaction ID. Successful reset/signOut publish null. */
+  addTransactionIdListener(fn: (transactionId: string | null) => void): () => void {
+    this.transactionIdListeners.add(fn);
+    return () => {
+      this.transactionIdListeners.delete(fn);
+    };
+  }
+
   /** Subscribe to a specific checkout event. Returns an unsubscribe function. */
   addEventListener<K extends EventName>(name: K, fn: (e: EventPayload<K>) => void): () => void {
     const wrapper = (e: CheckoutEvent) => {
@@ -165,6 +217,7 @@ export class OnramperClient {
   destroy(): void {
     this.stateListeners.clear();
     this.eventListeners.clear();
+    this.transactionIdListeners.clear();
     this.native.dispose();
   }
 }

package/src/index.ts

@@ -18,6 +18,7 @@ export type {
   OnramperLogLevel,
   OnramperState,
   OnramperTheme,
+  OnramperUserPrefill,
   QuoteResponse,
   RenderType,
   ReverificationField,

package/src/specs/OnramperNitro.nitro.ts

@@ -42,13 +42,18 @@ export interface OnramperNitro extends HybridObject<{ ios: 'swift' }> {
   // Fetches checkout requirements + quote, stores the SDK's SwiftUI checkout
   // button under a handle, and returns the handle + JSON-encoded quote. The
   // OnramperCheckoutButton Nitro view renders the stored button by handle.
-  // `requestJson` is a JSON CheckoutRequest; `styleJson` a JSON CheckoutButtonStyle.
-  getCheckoutRequirements(requestJson: string, styleJson: string): Promise<PreparedIntentResult>;
+  // `requestJson` is a JSON CheckoutRequest; `prefillJson` a JSON
+  // OnramperUserPrefill (`{}` when the caller supplied none); `styleJson` a JSON
+  // CheckoutButtonStyle. Argument order mirrors the SDK's
+  // `getCheckoutRequirements(_:prefill:buttonStyle:)`.
+  getCheckoutRequirements(requestJson: string, prefillJson: string, styleJson: string): Promise<PreparedIntentResult>;
   cancelPreparedIntent(intentHandle: string): Promise<void>;
 
   // Single native callback per stream; the JS wrapper fans out to multiple listeners.
   setStateListener(onState: (stateJson: string) => void): void;
   setEventListener(onEvent: (eventJson: string) => void): void;
+  // Mirrors OnramperSDK.$currentTransactionId. `undefined` represents native nil.
+  setTransactionIdListener(onTransactionId: (transactionId: string | undefined) => void): void;
 
   // The SDK's sessionExpirationHandler, as a stored async callback that returns
   // fresh credentials. Replaces the Expo-era onSessionExpired/provide/fail dance.

package/src/types.ts

@@ -69,6 +69,31 @@ export interface QuoteResponse {
   recommendations?: string[];
 }
 
+// Mirrors Swift `OnramperUserPrefill`. Values you already know about the user,
+// used to pre-populate the OnramperID sign-in and additional-info screens.
+// Every field is optional — supply only what you know.
+//
+// Prefill is **best-effort and never blocks sign-in**: if it can't be applied,
+// the login flow opens without it. Nothing surfaces to your app, and there is
+// no error to handle.
+//
+// `email` is the *binding identity*, not merely another prefilled value. When
+// it matches the account that signs in, the remaining values may be applied
+// automatically; when it does not match, the whole prefill is dropped — which
+// is strictly worse than omitting `email`, where the values are still offered
+// to the user for confirmation. Supply it only when you're confident it's the
+// address the user will sign in with.
+//
+// Prefill is enabled per integration — talk to your Onramper representative
+// before relying on it.
+export interface OnramperUserPrefill {
+  email?: string;
+  firstName?: string;
+  lastName?: string;
+  /** E.164 format, e.g. `+3712345678`. Always a candidate — the user still verifies it. */
+  phoneNumber?: string;
+}
+
 export interface CheckoutButtonStyle {
   backgroundColor?: string; // hex #RRGGBB or #RRGGBBAA
   foregroundColor?: string;
@@ -90,6 +115,8 @@ export interface HeadlessCheckoutData {
 
 export interface CheckoutFinalizeResponse {
   headlessCheckoutId: string;
+  /** Durable Onramper transaction identifier for support, reconciliation, and status lookups. */
+  onramperTransactionId: string;
   headlessCheckoutData: HeadlessCheckoutData;
 }