Front End Callbacks

The Connect SDK's provide callback functions to handle user interactions and deposit lifecycle events in your frontend application

Suggest Edits

onDeposit

Triggered when a deposit completes (successfully or unsuccessfully).

{  
"data": {  
  "depositId": "c55481bf-626b-4410-8997-4cee83e1385f",  
  "status": {  
    "value": "COMPLETED",  
    "details": "Deposit completed",  
    "occurredAt": "2025-10-07T19:44:50Z",  
   },  
"assetId": "btc"  
,  
"networkId": "bitcoin"  
,  
"amount": "0.013"  
 }  
}

onError

Triggered when errors occur during SDK operations (network issues, authentication failures, validation
errors, etc.).

{  
"errorCode": "auth_error",  
"reason": "Session expired. Please refresh your authentication token."  
}

onClose

Triggered when the user closes the Auth SDK interface. No payload provided.

onEvent - Deposit submitted

Triggered when a deposit is created and submitted (before it is confirmed on-chain).

{  
"type": "deposit.submitted",  
"data": {  
"depositId": "c55481bf-626b-4410-8997-4cee83e1385f"  
 }  
}

Implementation Example

import { Auth } from '@connect/auth-react';  
function App() {  
return (  
\<Auth  
jwt={yourJwtToken}  
env="sandbox"  
onDeposit={({ data }) => {  
console.log(`Deposit ${data.depositId}: ${data.status.value}`);  
}}  
onError={({ errorCode, reason }) => {  
console.error(`Error [${errorCode}]:
`  
, reason);  
}}  
onClose={() => {  
console.log('SDK closed');  
}}  
onEvent={({ type, data }) => {  
if (type === 'deposit.submitted') {  
console.log('Deposit submitted:'  
, data.depositId);  
}  
}}  
/>  
);  
}

React:

<connect-auth id="auth-sdk" jwt="your-jwt-token"></connect-auth>

<script type="module">
const auth = document.getElementById('auth-sdk');
auth.onDeposit = ({ data }) => {
console.log(`Deposit ${data.depositId}: ${data.status.value}`);
};
auth.onError = ({ errorCode, reason }) => {
console.error(`Error [${errorCode}]:
`
, reason);
};
auth.onClose = () => {
console.log('SDK closed');
};
auth.onEvent = ({ type, data }) => {
console.log

Updated about 4 hours ago