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/collectdu contexte.
- Name
useCollectOperators()- Description
Charge le catalogue (
data,loading,reload()).
- Name
useCollectActions()- Description
createPayment,confirmPayment,getPayment,payHostedSandbox+ étatsbusy/lastError.
Sécurité
N'exposez pas une clé Production dans le bundle navigateur. En production, appelez Collect depuis votre backend ou un BFF. Le playground utilise ce modèle en démo.