Partner API
test
  • latest
  • test
  1. User & KYC Webhooks
Partner API
test
  • latest
  • test
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Balances & Transaction History
        • Get Balances
        • Get Transaction History
        • Create Wallet
        • Create transfer master balance
      • Exchange Operations
        • Retrieve Exchange Rate
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
        • Retrieve Exchange Rate and Create a Lock
      • SEPA Transfers
      • Crypto Deposits
        • Update Travel Rule
      • Crypto Withdrawal
        • Get Crypto Withdrawal Details
        • Create Crypto Withdrawal
      • Orders
        • Retrieve Order Rate and Create a Lock
        • Create and Finalize an Order
        • Get Order Details
        • Get Rates
      • Payment link
        • Generate Payment Link
        • Get Payment Link Details
    • User Operations
      • Onboarding & KYC Flow
        • Create User Account
        • Method A: Add KYC File
        • Method B: Creating KYC Verification
        • Method B: Redirect to Verification
        • Method B: Get KYC Status
        • Add User Verification
        • Add POA File
      • Account Management
        • Update Existing User
        • Delete User
        • Suspend User
        • Unsuspend User
      • Balances & Transaction History
        • Get User Balances
        • Get User Transaction History
      • Currency Exchange
        • Retrieve Exchange Rate
        • Retrieve Exchange Rate and Create a Lock
        • Create and Finalize an Exchange
        • Retrieve Detailed Exchange Information
      • Internal Transfers
        • Create a Transfer
        • Get Transfer Details
      • Virtual Cards
        • Create Virtual Card
        • Get All User Cards
        • Get Card Details
        • Update Card PIN
        • Block Card
        • Unblock Card
        • Get Card Limits
        • Update Card Limits
        • Delete Card
      • Crypto Deposits
        • Update Travel Rule
      • Crypto Withdrawals
        • Get Network Fee
        • Create Crypto Withdrawal
        • Get Crypto Withdrawal Details
      • SEPA Transfers Copy
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
        • KYC File Added Webhook
        • POA Verification Status Webhook
        • KYC Verification Status Webhook
        • Create Wallet Webhook
      • Transfers & Payments Webhooks
        • P2P Transfer Webhook
        • SEPA Transfer Webhook
        • SEPA Deposit Webhook
        • Crypto Withdrawal Webhook
        • Crypto Deposit Webhook
        • Exchange Webhook
        • Card Transaction Webhook
        • Order status Webhook
        • Payment Link Webhook
      • Card Webhooks
        • Card 3DS Code Webhook
        • Card Activation Code Webhook
  • Reference
    • Supported Countries
    • Supported Currencies
    • Fees
    • FAQ
    • Changelog
    • Support
  1. User & KYC Webhooks

User Balance Generation Webhook

Webhook
POST
/webhook/user/status
This event is dispatched automatically upon successful verification of a user's KYC process.
It confirms that user balances have been generated and activated.
Depending on the verification level completed by the user, the event may include:
ACTIVE — the user has successfully completed standard KYC verification and can operate with crypto assets.
ACTIVE_EXTENDED — the user has passed an additional verification required for account extension, enabling card functionality.

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "externalUserId": "1867465a-aaed-45e3-b463-282e4f904a83",
    "balances": {
        "fiatBalances": [
            {
                "id": "c0545413-efd6-4f8e-97b8-f23753de9c31",
                "amount": "0.00",
                "name": "eur",
                "rate": 1,
                "status": "ACTIVE_EXTENDED"
            }
        ],
        "cryptoBalances": [
            {
                "id": "b55d3a5a-5a24-43c9-bdee-d22b707915b5",
                "amount": "0.000000",
                "name": "usdc",
                "wallet": "0xde0bc7fee9ee43f3d6adf685124bde16adbabbda",
                "rate": 0.862628,
                "networkConfig": {
                    "ethereum": {
                        "mainnet": false,
                        "name": "sepolia",
                        "withdrawal": {
                            "feeWithdrawal": 10,
                            "minWithdrawal": 1
                        },
                        "deposit": {
                            "minDeposit": 5
                        }
                    },
                    "polygon": {
                        "mainnet": false,
                        "name": "amoy",
                        "withdrawal": {
                            "feeWithdrawal": 0.5,
                            "minWithdrawal": 2
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "d526feb0-8cdb-4aef-8a5d-8c9e444ff7c6",
                "amount": "0.00000000",
                "name": "pol",
                "wallet": "0xde0bc7fee9ee43f3d6adf685124bde16adbabbda",
                "rate": 0.17269401,
                "networkConfig": {
                    "polygon": {
                        "mainnet": false,
                        "name": "amoy",
                        "withdrawal": {
                            "feeWithdrawal": 0.001,
                            "minWithdrawal": 0.00005
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "5836f0d6-3aed-4964-b5f2-c810a2e5e369",
                "amount": "0.00000000",
                "name": "ltc",
                "wallet": "tltc1qta85u858jm6q9t5cz3ngkthsvlxlckjhcyjjz9",
                "rate": 84.6200909,
                "networkConfig": {
                    "ltc": {
                        "mainnet": false,
                        "name": "test",
                        "withdrawal": {
                            "feeWithdrawal": 0.002,
                            "minWithdrawal": 0.001
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "4bba12ad-64ec-44d5-970f-6fcf10a40f4c",
                "amount": "0.00000000",
                "name": "doge",
                "wallet": "nfHU2iK5kU3F6M4xw5dkEF9URCFRseCw9U",
                "rate": 0.18163377,
                "networkConfig": {
                    "doge": {
                        "mainnet": false,
                        "name": "test",
                        "withdrawal": {
                            "feeWithdrawal": 5,
                            "minWithdrawal": 0.01
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "51df39b4-1a7f-4338-a171-ae8bdead9efc",
                "amount": "0.00000000",
                "name": "eth",
                "wallet": "0xde0bc7fee9ee43f3d6adf685124bde16adbabbda",
                "rate": 3612.4965451,
                "networkConfig": {
                    "ethereum": {
                        "mainnet": false,
                        "name": "sepolia",
                        "withdrawal": {
                            "feeWithdrawal": 0.003,
                            "minWithdrawal": 0.0006
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            },
            {
                "id": "b4f9dc86-495f-433c-9706-2e1dc084f3c3",
                "amount": "0.00000000",
                "name": "btc",
                "wallet": "tb1qxcsykv7xgut2x7a6gkxryk0rknx727u7vwhe0h",
                "rate": 99827.60682136,
                "networkConfig": {
                    "btc": {
                        "mainnet": false,
                        "name": "test",
                        "withdrawal": {
                            "feeWithdrawal": 0.0003,
                            "minWithdrawal": 0.000001
                        },
                        "deposit": {
                            "minDeposit": 0
                        }
                    }
                }
            }
        ]
    }
}'
Response Response Example
null
Previous
Webhooks
Next
KYC File Added Webhook
Built with