Overview

The @nekuda/react-nekuda-js securely collects user payment details, enabling your AI agents to manage guest checkouts.

Requirements:
• React 17+ or React 18
• Valid nekuda public key


Key Features:

  • PCI-compliant secure collection via isolated iframes
  • Customizable React components
  • Simple integration

Installation

npm install @nekuda/react-nekuda-js

Quick integration

Step 1: Obtain your nekuda public key from the nekuda Portal.

Step 2: Import the SDK

Step 3: Create the Payment Form Component

Step 4: Wrap Your App with the Provider

That’s it! This setup will render a complete payment form.


SDK Components & Usage

<NekudaWalletProvider>

Initializes the SDK and must wrap any components that use nekuda elements.

Example:

<NekudaPaymentForm>

A pre-built, styled payment form component that includes common payment fields.

Recommended Approach: We highly recommend using <NekudaPaymentForm> instead of individual field components. The complete form component automatically captures comprehensive payment data and user context that enhances payment success rates and provides valuable insights for transaction processing. This holistic approach ensures optimal performance and better user experience for your payment flows.

useNekudaWallet() Hook

Accesses SDK functionality and elements state from within components wrapped by <NekudaWalletProvider>.


Next Steps

After integrating the payment collection, make sure to integrate our backend SDK with nekuda-sdk to process the collected payment data.


Security and PCI Compliance

  • Secure Data Collection: Sensitive payment information (card number, CVC, expiry) is collected within secure iframes hosted by nekuda. This data never touches your servers directly.
  • Tokenization: Upon successful submission, the SDK returns a secure, single-use token representing the payment details. This token can be safely passed to your backend.
  • No PCI Scope: By using the iframed elements, your PCI DSS compliance scope is reduced, as you don’t handle or store raw cardholder data.