Inter-Business Transfer
Transfer float between Paybill, Merchant, and physical agent accounts in sub-180ms with developer encrypted PIN authorization.
Request Headers
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token) |
Content-Type | string | Required | application/json |
POST/v1/b2b/transfersLive & Sandbox
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
amount | number | Required | Transfer amount in KES |
destinationBusinessCode | string | Required | Business shortcode of the receiver |
reference | string | Required | Unique transfer reference |
note | string | Conditional | Optional transfer note |
Request Code Snippets (cURL, Node, Python, PHP, Go)
Request Example
curl -X POST https://developer.vixzz.com/v1/b2b/transfers \
-H "Authorization: Bearer vxz_tok_b2c_0a5l1n3m8x2z" \
-H "Idempotency-Key: idemp_b2b_9482" \
-H "Content-Type: application/json" \
-d '{
"sourceAccountType": "PAYBILL",
"sourceAccountId": "882190",
"destinationAccountType": "MERCHANT",
"destinationAccountId": "681029",
"amount": 250000,
"currency": "KES",
"encryptedPin": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA3f9...",
"remarks": "Float reallocation"
}'JSON Return Response Body (200 OK)
Response
{
"success": true,
"transferId": "B2B_TXN_992810",
"status": "COMPLETED",
"amount": 250000,
"currency": "KES",
"sourceBalanceAfter": 1450000,
"destinationBalanceAfter": 320000,
"completedAt": "2026-09-07T02:30:00.142Z"
}