Octane REST API
  1. Account Charges
Octane REST API
  • Getting Started
    • API Access & Authentication
    • API Rate Limiting
  • Integration Guides
    • Payment Integration
    • CDR Integration
    • Test Environment Data Sets
    • Mobile Flows
      • Activate Postpaid Mobile (New MSN - Physical SIM)
      • Activate Postpaid (Port MSN - Physical SIM)
      • Activate Postpaid Mobile (New MSN - eSIM)
      • Activate Postpaid (Port MSN - eSIM)
      • Reset eSIM Profile
      • Mobile Data Pool Flow
    • ConnectYou Flows
      • ConnectYou Business SIP Trunk Activate Flow
      • ConnectYou Business SIP Trunk Reactivate Direct Indials Flow
      • ConnectYou Unite Calling Activate Flow
    • NBN Flows
      • NBN Activate Flow
      • NBN Plan Change Flow
      • NBN Termination Flow
      • NBN Reschedule Appointment Flow
      • NBN Withdraw Order Flow
      • Run NBN Diagnostic Test Flow
      • Run NBN Service Health Check Flow
  • API Documentation
    • Customer
      • Add Customer
      • Get Customer Detail
      • List Customers
      • Update Customer
      • Set Customer Direct Debit
      • Send Welcome Email
    • Payment Method
      • List Payment Methods
      • Add Payment Method
      • Update Payment Method
      • Delete Payment Method
    • Transaction
      • List Transactions
      • Make Payment
      • Add Misc Adjustment
      • List Bounced Transactions
    • Plan
    • Service
      • List Services for a Customer
      • Get Service Detail by LineSeqNo
    • Mobile
      • Notification
        • Get Notification Settings
        • Update Notification Settings
      • Get Data Pool
      • Update Data Limit
      • Transfer Services to Another Pool
      • Disconnect a Data Pool
      • Get eSIM Details
      • Manage eSIM
    • Address
      • Search for an Address
      • Search for an Address V2
    • Service Qualification
      • Perform Service Qualification Check
    • Order
      • v1
        • Create Order (NBN Activation)
        • Create Order (NBN Modification)
        • Create Order (NBN Disconnection)
        • Cancel (NBN Activation) Order
        • Get Order Detail (NBN)
        • List Orders (NBN)
    • Enquiry
      • Create Enquiry (NBN Diagnostic Test / Service Health Check)
      • Get Enquiry Detail
      • List Enquiries
    • Appointment
      • Query Appointment Timeslots
      • Book Appointment
    • NBN
      • Get Available Diagnostic Tests
    • Attachment
  • API Documentation (Legacy APIs)
    • WSDL Summary
    • API Guide
      • Account Charges
        • Add a Recurring Charge
          POST
        • Get Recurring Charge Details
          POST
        • Add a Manual Charge
          POST
      • ConnectYou
        • Create a Number Reservation
        • Get Available Numbers
        • queryResiEndPointService
        • Query a Business SIP Trunk Service
        • Get Zone Detail
        • Get Number Detail
      • Contact Log
        • Get Contact Log Types
        • Add a Contact Log
        • Update a Contact Log
        • Query Contact Logs
      • Device
        • getSupplierStockDetail
        • getSupplierProduct
        • getSupplierFreightOption
        • orderDevice
      • Mobile
        • Get Mobile Provisioning Product Catalogue
        • Query a Mobile Service
        • Query Mobile Add Ons
        • Query Mobile Feature Settings
        • Query Mobile Balance
      • Notifications
        • createNotification
        • notificationManageTemplate
      • Pooled Resource
        • Reserve a Resource
        • Unreserve a Resource
        • Select a Resource
        • Query Resource
      • Order
        • Mobile Order
          • Create a Mobile Service (New Number)
          • Create a Mobile Service (Port In Number)
          • Create a Pre-Activation Mobile Order (New Number)
          • Bar/Unbar/Disconnect a Mobile Service
          • Change Mobile Rate Plan
          • Change a Mobile Number
          • Replace a SIM Card
          • Modify Mobile Feature(s)
          • Modify Mobile Feature Setting(s)
          • Change Excess Spend Limit
          • Add a Once-off Bolt On
          • Add a Recurring Bolt On Pack
          • Remove a Recurring Bolt On Pack
        • Mobile (Data Pool) Order
          • Create a Data Pool
          • Add Consumers to Data Pool
          • Remove Consumers from Data Pool
        • ConnectYou (SIP Trunk) Order
          • Create a New Business SIP Trunk
          • Bar/Unbar International Calls on a Business SIP Trunk
          • Suspend Business SIP Trunk
          • Unsuspend Business SIP Trunk
          • Deactivate Business SIP Trunk
          • Port Numbers to a Business SIP Trunk
          • Configure Business SIP Trunk
        • Other Rated Order
          • Create an Other Rated Service
          • Change Access of an Other Rated Service
        • Create an Order
        • Cancel an Order
        • Query an Order
        • Reset an Order
      • Statements & Billing
        • Get a List of Customer Bills
        • Get Charge Item Detail for a Bill
        • Get a Single Bill PDF for a Customer
        • Get a Summary of a Bill
      • Unbilled Calls
        • Query Summary of Unbilled Calls & Charges
        • Query Detail of Unbilled Calls & Charges
      • OTP
        • Manage OTP (Get & Verify OTP)
    • Reference Data
  1. Account Charges

Add a Recurring Charge

Testing Env
https://benzine.telcoinabox.com/tiab
Testing Env
https://benzine.telcoinabox.com/tiab
POST
https://benzine.telcoinabox.com/tiab
/UtbCharge
charge

UtbCharge:addRecurringCharge#

This service is to be exposed by the Octane application. This service will be used by external systems such as the Service Provider and other systems/sites to add a recurring charge to appear in the customers bill(s) in Octane.
This Octane service will be exposed as a SOAP message via the UtbCharge WSDL.

Request

Header Params
Content-Type
string 
required
Example:
text/xml; charset=utf-8
Body Params application/xml
Body
object 
required
addRecurringCharge
object 
required
Example
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <char:addRecurringCharge xmlns:char="http://charge.frontend.ws.utilibill.com.au/">
      <login>
        <userName>username</userName>
        <password>password</password>
      </login>
      <recurringCharge>
        <amountRecurring>388.87</amountRecurring>
        <chargeOngoing>true</chargeOngoing>
        <code>UTB:MISCO</code>
        <custNo>554433</custNo>
        <cycleInMonth>1</cycleInMonth>
        <description>instalment charge</description>
        <endDate>11/02/2025</endDate>
        <numberOfCycle>12</numberOfCycle>
        <pricePerUnit>208.18</pricePerUnit>
        <prorata>true</prorata>
        <quantity>1</quantity>
        <serviceNo>0395551234</serviceNo>
        <startDate>13/03/2024</startDate>
      </recurringCharge>
    </char:addRecurringCharge>
  </soapenv:Body>
</soapenv:Envelope>

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://benzine.telcoinabox.com/tiab/UtbCharge' \
--header 'Content-Type: text/xml; charset=utf-8' \
--data-raw '<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soapenv:Body>
    <char:addRecurringCharge xmlns:char="http://charge.frontend.ws.utilibill.com.au/">
      <login>
        <userName>username</userName>
        <password>password</password>
      </login>
      <recurringCharge>
        <amountRecurring>388.87</amountRecurring>
        <chargeOngoing>true</chargeOngoing>
        <code>UTB:MISCO</code>
        <custNo>554433</custNo>
        <cycleInMonth>1</cycleInMonth>
        <description>instalment charge</description>
        <endDate>11/02/2025</endDate>
        <numberOfCycle>12</numberOfCycle>
        <pricePerUnit>208.18</pricePerUnit>
        <prorata>true</prorata>
        <quantity>1</quantity>
        <serviceNo>0395551234</serviceNo>
        <startDate>13/03/2024</startDate>
      </recurringCharge>
    </char:addRecurringCharge>
  </soapenv:Body>
</soapenv:Envelope>'

Responses

🟢200addRecurringCharge response
application/xml
Body
Body
object 
required
addRecurringChargeResponse
object 
required
Example
<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header />
    <S:Body>
        <ns2:addRecurringChargeResponse xmlns:ns2="http://charge.frontend.ws.utilibill.com.au/">
            <return>
                <amountRecurring>388.87</amountRecurring>
                <chargeOngoing>true</chargeOngoing>
                <chargeOption></chargeOption>
                <code>UTB:MISCO</code>
                <custNo>382700</custNo>
                <cycleInMonth>1</cycleInMonth>
                <description>instalment charge</description>
                <endDate>11/02/2025</endDate>
                <isError>false</isError>
                <model></model>
                <numberOfCycle>12</numberOfCycle>
                <pricePerUnit>208.18</pricePerUnit>
                <prorata>true</prorata>
                <quantity>1</quantity>
                <serviceNo>OAC000000247218</serviceNo>
                <startDate>13/03/2024</startDate>
            </return>
        </ns2:addRecurringChargeResponse>
    </S:Body>
</S:Envelope>
🔴500SOAP API Exception (Charge)
Modified at 2024-03-20 07:16:15
Previous
WSDL Summary
Next
Get Recurring Charge Details
Built with