Inter-Business Transfer

Transfer float between Paybill, Merchant, and physical agent accounts in sub-180ms with developer encrypted PIN authorization.

Request Headers

HeaderTypeStatusDescription
AuthorizationstringRequiredBearer vxz_tok_* (OAuth 2.0 Scoped Bearer Token)
Content-TypestringRequiredapplication/json
POST/v1/b2b/transfersLive & Sandbox

Body Parameters (JSON)

ParameterTypeStatusDescription
amountnumberRequiredTransfer amount in KES
destinationBusinessCodestringRequiredBusiness shortcode of the receiver
referencestringRequiredUnique transfer reference
notestringConditionalOptional 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"
}