User Balance Generation Webhook

Webhook

POST

user-status-webhook

This event is dispatched automatically once a user's full onboarding and compliance checks have been successfully completed.
It serves as the final confirmation that all required internal procedures-including identity verification (KYC) and, if applicable, manual document reviews or Proof of Address (POA) verifications-are approved.

Upon this event, user balances (both fiat and crypto) are successfully generated and activated, along with their dedicated blockchain wallet addresses.

The payload structure provides the comprehensive state of the user's financial setup:

Fiat Balances: Contains the list of available fiat wallets and their current status assigned to the user.

Crypto Balances: Contains the list of supported cryptocurrencies, detailing network configurations, minimum deposit/withdrawal parameters, and the unique wallet addresses assigned to the user for processing external deposits.

Request

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
    "externalUserId": "56ab5f45-0f29-4053-a568-541a5a0a76b6",
    "balances": {
        "userId": "98206475-2c7f-4bbf-b2ff-d887b273ad39",
        "fiatBalances": [
            {
                "id": "f1e9d7cf-1a5f-4d46-a68c-789e5cbfd0a6",
                "amount": "0.00",
                "name": "eur",
                "rate": 1,
                "status": "ACTIVE"
            }
        ],
        "cryptoBalances": [
            {
                "id": "5ef83a58-bde9-4730-a28e-9b762a82add4",
                "amount": "0.00000000",
                "name": "btc",
                "rate": 63173.55248572,
                "networkConfig": {
                    "btc": {
                        "wallet": "2MzF1xPTw3ob4BotAr9TGVhGteB3gwGPf9M",
                        "mainnet": false,
                        "name": "test",
                        "withdrawal": {
                            "feeWithdrawal": 0.0003,
                            "minWithdrawal": 0.000001
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "e1b44754-bb85-4fbe-bcf7-5fefbdb50531",
                "amount": "0.00000000",
                "name": "ltc",
                "rate": 43.70782479,
                "networkConfig": {
                    "ltc": {
                        "wallet": "QMN9mYgUDg72NvDMaTTz9F4PU8igoNwJjp",
                        "mainnet": false,
                        "name": "test",
                        "withdrawal": {
                            "feeWithdrawal": 0.002,
                            "minWithdrawal": 0.001
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "61746ac3-433c-4403-868d-94364f610628",
                "amount": "0.00000000",
                "name": "eth",
                "rate": 1715.31640183,
                "networkConfig": {
                    "ethereum": {
                        "wallet": "0xbe9d8be0bd9de57b72a4fd2186e8ba3e76b1bd3d",
                        "mainnet": false,
                        "name": "sepolia",
                        "withdrawal": {
                            "feeWithdrawal": 0.003,
                            "minWithdrawal": 0.0006
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "56f1091c-11bc-45f7-8496-87699fb3b204",
                "amount": "0.000000",
                "name": "usdc",
                "rate": 0.860997,
                "networkConfig": {
                    "ethereum": {
                        "wallet": "0xbe9d8be0bd9de57b72a4fd2186e8ba3e76b1bd3d",
                        "mainnet": false,
                        "name": "sepolia",
                        "withdrawal": {
                            "feeWithdrawal": 10,
                            "minWithdrawal": 1
                        },
                        "deposit": {
                            "minDeposit": 5
                        }
                    },
                    "polygon": {
                        "wallet": "0x2bde7fafc65e3da9bed2790971a88b39e6112532",
                        "mainnet": false,
                        "name": "amoy",
                        "withdrawal": {
                            "feeWithdrawal": 0.5,
                            "minWithdrawal": 2
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "ba210fcf-2ee2-4255-a5df-e56311ab4564",
                "amount": "0.000000",
                "name": "eurc",
                "rate": 0.999856,
                "networkConfig": {
                    "ethereum": {
                        "wallet": "0xbe9d8be0bd9de57b72a4fd2186e8ba3e76b1bd3d",
                        "mainnet": false,
                        "name": "sepolia",
                        "withdrawal": {
                            "feeWithdrawal": 10,
                            "minWithdrawal": 4
                        },
                        "deposit": {
                            "minDeposit": 5
                        }
                    }
                }
            },
            {
                "id": "cbe8eb7c-c6bc-4245-8075-7caa7b4b6845",
                "amount": "0.00000000",
                "name": "pol",
                "rate": 0.07550605,
                "networkConfig": {
                    "polygon": {
                        "wallet": "0x2bde7fafc65e3da9bed2790971a88b39e6112532",
                        "mainnet": false,
                        "name": "amoy",
                        "withdrawal": {
                            "feeWithdrawal": 0.5,
                            "minWithdrawal": 0.00005
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "fba53bda-4a53-4bda-a568-33dd0bb1adfc",
                "amount": "0.00000000",
                "name": "doge",
                "rate": 0.08483232,
                "networkConfig": {
                    "doge": {
                        "wallet": "npHVHRg2NpAZqhqkva6YrRm97XpGy3LuD7",
                        "mainnet": false,
                        "name": "test",
                        "withdrawal": {
                            "feeWithdrawal": 5,
                            "minWithdrawal": 0.01
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            }
        ]
    }
}'

Response Example

null

Webhooks

KYC File Added Webhook