SDK React

Package npm @fluxx/collect-react (2026-06). React 18+, s'appuie sur @fluxx/collect.


Installation

npm install @fluxx/collect @fluxx/collect-react

Provider

import { CollectProvider } from '@fluxx/collect-react'

export function App({ children }: { children: React.ReactNode }) {
  return (
    <CollectProvider
      apiKey={process.env.FLUXX_API_KEY!}
      environment="test"
    >
      {children}
    </CollectProvider>
  )
}

Les options du provider reprennent celles de @fluxx/collect (baseUrl, maxRetries, etc.).


Hooks

Exemple

import { useCollectOperators, useCollectActions } from '@fluxx/collect-react'

function PayButton() {
  const { data, loading } = useCollectOperators()
  const { createPayment, confirmPayment, busy } = useCollectActions()

  async function handlePay() {
    const init = await createPayment(
      {
        reference: 'ORDER-001',
        amount: 3000,
        country: 'BJ',
        mode: 'direct',
        operator: 'mtn',
        customer: { phone: '2290166000000' },
      },
      { idempotencyKey: 'ORDER-001' },
    )
    if (init.status === 'awaiting_otp') {
      await confirmPayment({ reference: 'ORDER-001', otp: '123456' })
    }
  }

  if (loading) return <span>Chargement…</span>
  return (
    <button type="button" disabled={busy} onClick={() => void handlePay()}>
      Payer
    </button>
  )
}
  • Name
    useCollectClient()
    Description

    Instance @fluxx/collect du contexte.

  • Name
    useCollectOperators()
    Description

    Charge le catalogue (data, loading, reload()).

  • Name
    useCollectActions()
    Description

    createPayment, confirmPayment, getPayment, payHostedSandbox + états busy / lastError.


Sécurité


Voir aussi

SDK JavaScript

Client @fluxx/collect utilisé par les hooks React.

En savoir plus

Référence API Collect

Contrat HTTP derrière le provider et les hooks.

En savoir plus

Playground sandbox

Valider le parcours avant de brancher votre UI.

En savoir plus

Was this page helpful?