Partner API
  1. User & KYC Webhooks
Partner API
  • Getting Started
    • Introduction
    • Authentication
    • Business Use Cases
  • API References
    • Partner Operations
      • Get Balances
      • Create Wallet
      • Get Transaction History
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Information
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
      • Create a SEPA Transfer
      • Get SEPA Transfer Details
    • User Accounts
      • Create User Account
      • Add KYC File
      • Add POA File
      • Add User Verification
      • Extend user
      • Update Existing User
      • Delete User
      • Suspend User
      • Unsuspend User
      • Get User Balances
      • Get User Transaction History
    • KYC by P100
      • Creating KYC Verification
      • Redirect to Verification
      • Get KYC Status
    • Currency Exchange
      • Retrieve Exchange Rate
      • Retrieve Exchange Rate and Create a Lock
      • Create and Finalize an Exchange
      • Retrieve Detailed Exchange Information
    • Crypto Deposits
      • Update Travel Rule
    • Crypto Withdrawals
      • Get Network Fee
      • Create Crypto Withdrawal
      • Get Crypto Withdrawal Details
    • 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
    • Custom Fiat Operations
      • SEPA Deposit & Withdrawal
    • Orders
      • Get Rates
      • Retrieve Order Rate and Create a Lock
      • Create and Finalize an Order
      • Get Order Details
    • Payment link
      • Generate Payment Link
      • Get Payment Link Details
  • Integration
    • SDKs & Integration Guides
    • Transaction Processing
    • Error Handling
    • Rate Limiting
    • Webhooks
      • User & KYC Webhooks
        • User Balance Generation Webhook
          POST
        • KYC File Added Webhook
          POST
        • POA Verification Status Webhook
          POST
        • KYC Verification Status Webhook
          POST
        • Create Wallet Webhook
          POST
      • 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