Octane REST API
  1. Customer
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
        POST
      • Get Customer Detail
        GET
      • List Customers
        GET
      • Update Customer
        PATCH
      • Set Customer Direct Debit
        POST
      • Send Welcome Email
        POST
    • 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
        • Get Recurring Charge Details
        • Add a Manual Charge
      • 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. Customer

Set Customer Direct Debit

Testing Env
https://benzine.telcoinabox.com/tiab/api
Testing Env
https://benzine.telcoinabox.com/tiab/api
POST
https://benzine.telcoinabox.com/tiab/api
/v1/group/{groupno}/customer/{custno}/direct-debit
This API can be used to set the direct debit details of an existing Customer Account.

Request

Authorization
Send your HTTP requests with an
Authorization
header that contains the word Basic followed by a space and a base64-encoded string username:password
Example:
Authorization: Basic *****************
Path Params
groupno
string 
required
Group Number. Users will have access only to specific Groups and must pass this ID when accessing any Resources via API.
custno
integer 
required
Unique identifer of the End Customer Account to retrieve details for.
Body Params application/json
directDebit
object (Direct Debit) 
required
Defines the Direct Debit Setup for the Customer
directDebitType
enum<string> 
required
Indicates what direct debit type is used for this customer
Allowed values:
STANDARD_DIRECT_DEBITSPECIAL_DIRECT_DEBITOFF
ddNotificationFlag
enum<string> 
required
Indicates whether to use the Customer's contact email (Y) or the DD Notification Email (N) instead.
Allowed values:
YN
ddNotificationEmail
string 
optional
The alternate email to send direct debit notifications to.
ddPaymentDay
string 
optional
The day of the month to take payments on. If left blank, this will be defaulted to Day 15.
ddSpecialPaymentPeriod
enum<string> 
optional
Can be set to configure a payment plan for a Customer where you want to take regular payments on a pre-defined schedule.
Allowed values:
wkfnmn
ddSpecialPaymentMethod
enum<string> 
optional
Type of payment to make. This can either be configured to take payment from the total balance or the overdue balance only
Allowed values:
STSO
ddSpecialPaymentAmount
number <double>
optional
Amount to take on every direct debit run. Can be configured to setup a payment plan for a Customer. Rounded down to 2 decimal places
ddSpecialDayOfWeek
enum<integer> 
optional
Can be configured to specify the day of the week to take the direct debit on (as opposed to a specific day of the month).
Allowed values:
1234567
ddSpecialStartDate
string <date-time>
optional
Used to set the start date for the payment plan. Format: yyyy-mm-dd
ddSpecialEndDate
string <date-time>
optional
Used to set the end date for the payment plan. Format: yyyy-mm-dd
If neither of ddSpecialEndDate nor ddSpecialRequiredCount is provided, the direct debit payments will continue indefinitely.
ddSpecialRequiredCount
integer 
optional
Indicates the number of recurrences to execute direct debit for, based on the defined schedule. This can be provided instead of specifying an End Date.
If neither of ddSpecialEndDate nor ddSpecialRequiredCount is provided, the direct debit payments will continue indefinitely.
Example
{
    "directDebit": {
        "directDebitType": "STANDARD_DIRECT_DEBIT",
        "ddNotificationFlag": "Y",
        "ddNotificationEmail": "string",
        "ddPaymentDay": "string",
        "ddSpecialPaymentPeriod": "wk",
        "ddSpecialPaymentMethod": "ST",
        "ddSpecialPaymentAmount": 0,
        "ddSpecialDayOfWeek": 1,
        "ddSpecialStartDate": "2019-08-24T14:15:22Z",
        "ddSpecialEndDate": "2019-08-24T14:15:22Z",
        "ddSpecialRequiredCount": 0
    }
}

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/api/v1/group//customer//direct-debit' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "directDebit": {
        "directDebitType": "STANDARD_DIRECT_DEBIT",
        "ddNotificationFlag": "Y",
        "ddNotificationEmail": "string",
        "ddPaymentDay": "string",
        "ddSpecialPaymentPeriod": "wk",
        "ddSpecialPaymentMethod": "ST",
        "ddSpecialPaymentAmount": 0,
        "ddSpecialDayOfWeek": 1,
        "ddSpecialStartDate": "2019-08-24T14:15:22Z",
        "ddSpecialEndDate": "2019-08-24T14:15:22Z",
        "ddSpecialRequiredCount": 0
    }
}'

Responses

🟢200Success
application/json
Body
directDebit
object (Direct Debit) 
required
Defines the Direct Debit Setup for the Customer
directDebitType
enum<string> 
required
Indicates what direct debit type is used for this customer
Allowed values:
STANDARD_DIRECT_DEBITSPECIAL_DIRECT_DEBITOFF
ddNotificationFlag
enum<string> 
required
Indicates whether to use the Customer's contact email (Y) or the DD Notification Email (N) instead.
Allowed values:
YN
ddNotificationEmail
string 
optional
The alternate email to send direct debit notifications to.
ddPaymentDay
string 
optional
The day of the month to take payments on. If left blank, this will be defaulted to Day 15.
ddSpecialPaymentPeriod
enum<string> 
optional
Can be set to configure a payment plan for a Customer where you want to take regular payments on a pre-defined schedule.
Allowed values:
wkfnmn
ddSpecialPaymentMethod
enum<string> 
optional
Type of payment to make. This can either be configured to take payment from the total balance or the overdue balance only
Allowed values:
STSO
ddSpecialPaymentAmount
number <double>
optional
Amount to take on every direct debit run. Can be configured to setup a payment plan for a Customer. Rounded down to 2 decimal places
ddSpecialDayOfWeek
enum<integer> 
optional
Can be configured to specify the day of the week to take the direct debit on (as opposed to a specific day of the month).
Allowed values:
1234567
ddSpecialEndType
enum<string> 
read-onlyoptional
Read-only. Indicates the type of end date configured for this payment plan setup.
Allowed values:
EAEDEN
ddSpecialStartDate
string <date-time>
optional
Used to set the start date for the payment plan. Format: yyyy-mm-dd
ddSpecialEndDate
string <date-time>
optional
Used to set the end date for the payment plan. Format: yyyy-mm-dd
If neither of ddSpecialEndDate nor ddSpecialRequiredCount is provided, the direct debit payments will continue indefinitely.
ddSpecialRequiredCount
integer 
optional
Indicates the number of recurrences to execute direct debit for, based on the defined schedule. This can be provided instead of specifying an End Date.
If neither of ddSpecialEndDate nor ddSpecialRequiredCount is provided, the direct debit payments will continue indefinitely.
ddSpecialCurrentCount
integer 
read-onlyoptional
Read-only. Will return an indicator of how many payment recurrences have been completed so far based on the required count configured.
Example
{
    "directDebit": {
        "directDebitType": "STANDARD_DIRECT_DEBIT",
        "ddNotificationFlag": "Y",
        "ddNotificationEmail": "string",
        "ddPaymentDay": "string",
        "ddSpecialPaymentPeriod": "wk",
        "ddSpecialPaymentMethod": "ST",
        "ddSpecialPaymentAmount": 0,
        "ddSpecialDayOfWeek": 1,
        "ddSpecialEndType": "EA",
        "ddSpecialStartDate": "2019-08-24T14:15:22Z",
        "ddSpecialEndDate": "2019-08-24T14:15:22Z",
        "ddSpecialRequiredCount": 0,
        "ddSpecialCurrentCount": 0
    }
}
🟠403Invalid access
Modified at 2024-10-15 08:18:38
Previous
Update Customer
Next
Send Welcome Email
Built with