Subaccount Created
{
"event": "subaccount.status.created",
"data": {
"id": "7625a677-44e1-4b96-b0d0-ba86af1b93cc",
"email": "[email protected]",
"status": "created"
}
}
Subaccount In Review
{
"event": "subaccount.status.review",
"data": {
"id": "7625a677-44e1-4b96-b0d0-ba86af1b93cc",
"email": "[email protected]",
"status": "review"
}
}
Subaccount Approved
When a subaccount is approved, the webhook includes a detailedcapabilities object showing which currencies, rails, and crypto assets are unlocked.
{
"event": "subaccount.status.approved",
"data": {
"id": "b6fe2299-ffaf-4468-bffe-415e22038921",
"email": "[email protected]",
"status": "approved",
"capabilities": {
"kyc": {
"profiles": [
{
"country": "NG",
"status": "approved"
},
{
"country": "GH",
"status": "approved"
},
{
"country": "ZM",
"status": "approved"
}
]
},
"capabilities": {
"currencies": {
"NGN": {
"status": "approved",
"canOnramp": true,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"banktransfer": true
}
},
"GHS": {
"status": "approved",
"canOnramp": true,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"momo": true
}
},
"ZMW": {
"status": "approved",
"canOnramp": true,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"momo": true
}
},
"USD": {
"status": "locked",
"canOnramp": false,
"canOfframp": false,
"canDeposit": false,
"canWithdraw": false,
"requiredKyc": "Additional Verification required for USD operations",
"rails": {
"wire": false,
"ach": false,
"swift": false
}
}
},
"assets": {
"USDT": {
"networks": ["ETH-SEPOLIA", "SOL-DEVNET", "CELO-SEPOLIA"]
},
"USDC": {
"networks": ["ETH-SEPOLIA", "SOL-DEVNET", "CELO-SEPOLIA", "POLY-AMOY"]
},
"EURC": {
"networks": ["ETH-SEPOLIA", "SOL-DEVNET", "CELO-SEPOLIA"]
},
"BTC": {
"networks": ["LIGHTNING"]
}
}
}
}
}
}
{
"event": "subaccount.status.approved",
"data": {
"id": "ac5ee406-3d18-4dd7-9e68-f3e06c6f906a",
"email": "[email protected]",
"status": "approved",
"capabilities": {
"kyc": {
"profiles": [
{
"country": "US",
"status": "approved"
},
{
"country": "EU",
"status": "approved"
},
{
"country": "GH",
"status": "approved"
},
{
"country": "ZM",
"status": "approved"
}
]
},
"capabilities": {
"currencies": {
"USD": {
"status": "partial",
"canOnramp": false,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"wire": true,
"ach": false,
"swift": false
}
},
"EUR": {
"status": "partial",
"canOnramp": false,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"sepa": true
}
},
"GHS": {
"status": "approved",
"canOnramp": true,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"momo": true
}
},
"ZMW": {
"status": "approved",
"canOnramp": true,
"canOfframp": true,
"canDeposit": true,
"canWithdraw": true,
"rails": {
"momo": true
}
},
"NGN": {
"status": "locked",
"canOnramp": false,
"canOfframp": false,
"canDeposit": false,
"canWithdraw": false,
"requiredKyc": "Additional Verification required for NGN operations",
"rails": {
"banktransfer": false
}
}
},
"assets": {
"USDT": {
"networks": ["ETH-SEPOLIA", "SOL-DEVNET", "CELO-SEPOLIA"]
},
"USDC": {
"networks": ["ETH-SEPOLIA", "SOL-DEVNET", "CELO-SEPOLIA", "POLY-AMOY"]
},
"EURC": {
"networks": ["ETH-SEPOLIA", "SOL-DEVNET", "CELO-SEPOLIA"]
},
"BTC": {
"networks": ["LIGHTNING"]
}
}
}
}
}
}
approved: Full access - all operations enabledlocked: No access - additional verification requiredpartial: Limited access - some operations/rails enabled
Subaccount Declined
When a subaccount is declined, the payload includes afailure_reason and a boolean can_resubmit indicating if the user is allowed to try again.
{
"event": "subaccount.status.declined",
"data": {
"id": "7ae50606-4422-4b8d-8604-543686e4472d",
"email": "[email protected]",
"status": "declined",
"failure_reason": "BAD_PROOF_OF_ADDRESS",
"can_resubmit": true
}
}
{
"event": "subaccount.status.declined",
"data": {
"id": "7ae50606-4422-4b8d-8604-543686e4472d",
"email": "[email protected]",
"status": "declined",
"failure_reason": "FORGERY",
"can_resubmit": false
}
}