Validate an Account
post
/bcws/webresources/v1.0/accounts/validate
Validates the registration data for the specified account.
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
The data for an account. The minimum required parameters are:
- contacts
- address
- city
- country
- firstName
- lastName
Root Schema : schema
Type:
Show Source
object
-
billUnits: array
billUnits
-
businessType: integer
(int32)
The business type: consumer (1) or business (2).
-
contacts(required): array
contacts
An account's contact information.
-
currency: integer
(int32)
The account's primary currency.
-
customerTypeCode: integer
(int32)
The customer type: standard (1), brand (2), or subscription (3).
-
effective: string
(date-time)
The date and time the account takes effect.
-
extension: object
extension
The extended attributes.
-
genericBundle: object
CustomizedBundleForPurchase
-
locale: string
The customer's locale, such as en_US or fr_FR. For a list of valid values, see "Locale Names" in BRM Developer's Guide.
-
notes: object
Notes
-
organizationHierarchyTypeCode: integer
(int32)
The code for the account organization hierarchy type, such as site or legal entity.
-
parentRef: object
ResourceRef
-
paymentMethod: array
paymentMethod
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10000:Prepaid
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
-
profiles: array
profiles
-
purchasingPlanRef: string
The resource for the purchased package, such as 0.0.0.1+-plan+45678.
-
securityCode1: string
A security code used to verify account access. This provides an authentication test for customer service requests.
-
securityCode2: string
A security code used to verify account access. This provides an authentication test for customer service requests.
-
services(required): array
services
-
status: string
The account's status: active (10100), inactive (10102), or closed (10103).
-
timezoneId: string
The ID for the customer's timezone.
-
wallet: object
Wallet
Nested Schema : contacts
Type:
array
An account's contact information.
Show Source
-
Array of:
object contacts
An account's contact information.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : CustomizedBundleForPurchase
Type:
Show Source
object
-
creditLimitFlags: integer
(int32)
Flag to set credit limit options. Allowed Values: 1 (Override credit limit), 2 (Prorate based on credit limit), 64 (Enforce credit limit).
-
customizedChargeOffers: array
customizedChargeOffers
The list of customized charge offers in the bundle.
-
customizedDiscountOffers: array
customizedDiscountOffers
The list of customized discount offers.
-
effective: string
(date-time)
The date and time the bundle takes effect.
-
extension: object
extension
The extended attributes.
-
id(required): string
The ID.
-
name(required): string
The bundle's name.
-
notes: object
Notes
Nested Schema : Notes
Type:
Show Source
object
-
accountId(required): string
The ID of the account associated with the note.
-
amount: number
The amount associated with the note. It can be a payment amount, adjustment amount, or so on.
-
billId: string
The ID of the bill associated with the note.
-
billUnitId: string
The ID of the bill unit associated with the note.
-
closedDate: string
(date-time)
The date and time the note was resolved.
-
comments: array
comments
The list of comments associated with the note.
-
count: integer
(int32)
The number of comments associated with the note.
-
domainId: integer
(int32)
The domain ID associated with the note.
-
effectiveDate: string
(date-time)
The date and time the comment was posted.
-
eventId: string
The ID of the event associated with the note.
-
extension: object
extension
The extended attributes.
-
header: string
The header associated with the note.
-
id: string
The ID.
-
itemId: string
The ID of the item associated with the note.
-
reasonId: integer
(int32)
The reason ID associated with the note. Possible values are stored in /config/reason_code_scope objects. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the reasons.locale file.
-
serviceId: string
The service ID associated with the note.
-
status: number
The note's status: not set (100), resolved (101), or unresolved (102). The default value is 102.
-
subType: integer
(int32)
The note's subtype. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.
-
type: integer
(int32)
The note's type. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.
Nested Schema : ResourceRef
Type:
Show Source
object
-
id(required): string
The ID.
-
uri: string
The Uniform Resource Identifier (URI) associated with the resource.
Nested Schema : profiles
Type:
Show Source
array
-
Array of:
object Discriminator: @class
Discriminator:
{ "propertyName":"@class" }
Nested Schema : Wallet
Type:
Show Source
object
-
extension: object
extension
The extended attributes.
-
paymentInstrument: array
paymentInstrument
Nested Schema : NewBillUnits
Type:
Show Source
object
-
accountingCycleDom: integer
(int32)
The accounting cycle day of month (DOM).
-
accountingType: integer
(int32)
The accounting type. Can be one of the following:
- 1: Open item
- 2: Balance forward
-
arBillUnitRef: object
ResourceRef
-
balanceGroups: array
balanceGroups
-
billingFrequencyInMonths: integer
(int32)
The billing frequency in number of months. Can be one of the following:
- 1: Monthly
- 2: Bi-monthly
- 3: Quarterly
- 12: Yearly
-
businessProfile(required): string
The business profile associated with bill unit.
-
currency: integer
(int32)
The primary currency of the bill unit.
-
effectiveDate: string
(date-time)
The date and time the bill unit takes effect.
-
forServiceGroup(required): array
forServiceGroup
-
name: string
The name of the bill unit.
-
parentBillUnitRef: object
ResourceRef
-
parentRef: string
A reference to the parent.
-
paymentMethod: object
PaymentMethod
-
paymentMethodId: string
The ID of the payment method.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
-
rollUp: boolean
-
segment: integer
(int32)
The customer segment associated with the bill unit. A customer segment is a user-defined customer description that can be used to group accounts according to customer billing and payment practices.
-
status: string
The status of the bill unit, such as active, inactive, or closed.
-
walletPaymentInstrumentIndex: integer
(int32)
The wallet index number for the payment instrument associated with the bill unit.
Nested Schema : PaymentMethod
Type:
Show Source
object
-
creditCard: object
CreditCardType
-
directDebit: object
DirectDebitType
-
extension: object
extension
The extended attributes.
-
invoice: object
InvoiceType
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
-
sepa: object
SepaType
Nested Schema : BalanceGroup
Type:
Show Source
object
-
balances: array
balances
The list of balances associated with the balance group.
-
elem: integer
(int32)
The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
-
extension: object
extension
The extended attributes.
-
id(required): string
The ID.
-
monitorType: string
The monitoring group type. Allowed Values:
- H_CE (Hierarchy Credit Exposure)
- PR_CE (Payment Responsible Credit Exposure)
- SUB_CE (Subscription Credit Exposure)
- PR_RTCE (Payment Responsible Real-Time Credit Enforcement)
-
name: string
The name of the balance group.
-
services: array
services
Nested Schema : balances
Type:
array
The list of balances associated with the balance group.
Show Source
-
Array of:
object Balances
The list of balances associated with the balance group.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : Balances
Type:
object
The list of balances associated with the balance group.
Show Source
-
creditFloor: number
The credit floor associated with the balance.
-
creditLimit: number
The credit limit associated with the balance.
-
creditThresholds: integer
(int32)
The credit thresholds associated with the balance.
-
creditThresholdsFixed: string
The value at which to send a notification, such as 30 US dollars or 30 minutes.
-
currentBalance(required): number
The current balance.
-
dynamicCreditFloor: boolean
Whether to use a dynamic credit floor (true) or not (false). The default is false.
-
expiredBeforeUsing: number
The number of days until the balance expires.
-
formattedCreditThresholds: string
The balance percentage usage at which to notify the customer.
-
loanThresholds: integer
(int32)
The percent-based threshold for offering a loan. If the customer's balance falls below this percent, they are notified and offered a loan.
-
loanThresholdsFixed: string
The fixed amount threshold for offering a loan. If the customer's balance falls below this amount, they are notified and offered a loan.
-
modifyLimit: boolean
Whether a credit limit is being modified by the request (true) or not (false).
-
outstandingAmount(required): number
An amount that the customer still owes, for loans or when they exceed their credit limit.
-
overrideCreditLimit: integer
(int32)
Whether to override the credit limit. Allowed Values: 0 (Enforce Credit Limit) or 1 (Override credit limit).
-
resourceId: integer
(int32)
The resource ID associated with the balance.
-
subBalances: array
subBalances
-
tempCreditLimit: array
tempCreditLimit
Nested Schema : SubBalances
Type:
Show Source
object
-
currentBalance: number
The current amount of the sub-balance.
-
elementId: integer
(int32)
The ID of the element.
-
expiredBeforeUsing: number
The number of days until the sub-balance expires.
-
extension: object
extension
The extended attributes.
-
rolloverData: integer
(int32)
Details about a rollover subbalance.
-
validFrom: string
(date-time)
The date and time the validity period starts.
-
validTo: string
(date-time)
The date and time the validity period ends.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : TempCreditLimit
Type:
Show Source
object
-
extension: object
extension
The extended attributes.
-
limit: number
The temporary credit limit amount.
-
resourceId: integer
(int32)
The resource ID associated with the temporary credit limit.
-
validFrom(required): string
(date-time)
The date and time temporary credit limit's validity starts.
-
validFromOffset: integer
(int32)
The offset for the temporary credit limit's validity period start.
-
validFromUnit: integer
(int32)
The unit for the temporary credit limit's validity period start.
-
validTo(required): string
(date-time)
The date and time temporary credit limit's validity ends.
-
validToOffset: integer
(int32)
The offset for the temporary credit limit's validity period end.
-
validToUnit: integer
(int32)
The unit for the temporary credit limit's validity period end.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : ServiceType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
aliasList: array
aliasList
The list of aliases associated with the service.
-
balanceGroupRef: object
ResourceRef
-
balGrpIndex: integer
(int32)
The balance group index.
-
creationDate: string
(date-time)
The date and time the service type was created.
-
effectiveDate: string
(date-time)
-
extension: object
extension
The extended attributes.
-
id: object
ResourceRef
-
lastModified: string
(date-time)
The date and time the service was last modified.
-
lastStatusChange: string
(date-time)
The date and time of the last status change.
-
lastStatusComment: string
The comment associated with the last status change.
-
lifeCycleState: integer
(int32)
The current life cycle state.
-
login(required): string
The login associated with the service.
-
name: string
The name of the service.
-
password(required): string
The password associated with the service.
-
passwordExpiration: string
(date-time)
The date and time the password expires.
-
passwordStatus: integer
(int32)
The current status of the password.
-
pendingDeferredActionsCount: integer
(int32)
The number of deferred actions that are pending for the service.
-
serviceAccessLevel: string
The service access level.
-
status: integer
(int32)
The status.
-
statusFlags: integer
(int32)
The status flags.
-
subscriptionServiceRef: object
ResourceRef
Nested Schema : aliasList
Type:
array
The list of aliases associated with the service.
Show Source
-
Array of:
object AliasList
The list of aliases associated with the service.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : ServiceGroupIndex
Type:
Show Source
object
-
serviceGroupElem: integer
(int32)
The service group element.
Nested Schema : CreditCardType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : DirectDebitType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : InvoiceType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : SepaType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : Details
Type:
object
The offer details.
Show Source
-
balanceImpactResource(required): string
The resource that represents the balance impact of the offer.
-
fixedAmount: number
(float)
The fixed amount of the offer.
-
fixedPriceTag(required): string
The fixed price tag of the offer.
-
scaledAmount: number
(float)
The scaled amount of the offer.
-
scaledPriceTag(required): string
The scaled price tag of the offer.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : contacts
Type:
object
An account's contact information.
Show Source
-
address(required): string
The customer's address.
-
city(required): string
The customer's city.
-
company: string
The company name.
-
contactType: string
The contact type.
-
country(required): string
The customer's country.
-
deleted: boolean
Default Value:
false
Whether to delete the contact (true) or not (false). This must be set to false if you adding a contact. -
elem: integer
(int32)
The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
-
emailAddress: string
The customer's email address.
-
firstName(required): string
The customer's first name.
-
lastName(required): string
The customer's last name.
-
middleName: string
The customer's middle name.
-
newlyCreated: boolean
Default Value:
false
Whether the contact information was newly created (true) or not (false). -
phonenumbers: array
phonenumbers
The list of associated phone numbers.
-
salutation: string
The salutation to use use with the customer, such as Mr. or Miss.
-
state: string
The customer's state.
-
title: string
The customer's job title.
-
zip: string
The ZIP code.
Nested Schema : phonenumbers
Type:
array
The list of associated phone numbers.
Show Source
-
Array of:
object Phonenumbers
The list of the account's phone numbers.
Nested Schema : Phonenumbers
Type:
object
The list of the account's phone numbers.
Show Source
-
number(required): string
The phone number.
-
phonetype: integer
(int32)
The phone number's type.
Nested Schema : customizedChargeOffers
Type:
array
The list of customized charge offers in the bundle.
Show Source
-
Array of:
object CustomizedChargeOffers
The list of customized charge offers in the bundle.
Nested Schema : customizedDiscountOffers
Type:
array
The list of customized discount offers.
Show Source
-
Array of:
object CustomizedDiscountOffers
The list of customized discount offers.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : CustomizedChargeOffers
Type:
object
The list of customized charge offers in the bundle.
Show Source
-
baseChargeOfferRef: object
ResourceRef
-
baseProductRef: object
ResourceRef
-
cycleDiscountOverride: number
The fixed amount of the cycle discount override.
-
cycleDiscountPercentOverride: number
The percentage amount of the cycle discount override.
-
cycleEnd: object
EndingType
-
cycleFeeOverride: number
The amount of the cycle fee override.
-
cycleStart: object
StartingType
-
description: string
The charge offer's description.
-
gracePeriodOffset: integer
(int32)
The number to offset the grace period by.
-
gracePeriodUnit: integer
(int32)
The unit for the grace period.
-
name: string
The charge offer's name.
-
overriddenCharges: array
overriddenCharges
The overridden charges.
-
purchaseDiscountOverride: number
The fixed amount of the purchase discount override.
-
purchaseDiscountPercentOverride: number
The percentage amount of the purchase discount override.
-
purchaseEnd: object
EndingType
-
purchaseFeeOverride: number
The fixed amount of the purchase fee override.
-
purchaseStart: object
StartingType
-
quantity: integer
(int32)
The quantity purchased.
-
renewalMode: integer
(int32)
How to handle the charge offer's cycle alignment when its bundle is reactivated. Possible values are:
- 0: Cycle aligns with the original billing date or configured specific day of the month.
- 1: Cycle aligns with the reactivation date.
-
status: integer
(int32)
The charge offer's status. Can be one of the following:
- 0: Not set
- 1: Active
- 2: Inactive
- 3: Canceled
-
statusFlag: integer
(int32)
The status flag.
-
usageEnd: object
EndingType
-
usagePercentOverride: number
The percentage amount of the usage override.
-
usageStart: object
StartingType
-
validityAlignMode: string
The validity align mode for a product. Can be one of the following:
- base: Align the validity with baseProductRef passed in request
- any_base_earliest: Aligns the validity dates with the active base charge offer that expires first.
- any_base_latest: Aligns the validity dates with the active base charge offer that expires last.
- any_earliest: Aligns the validity dates with the active charge offer that expires first.
- any_latest: Aligns the validity dates with the active charge offer that expires last.
Nested Schema : EndingType
Type:
Show Source
object
-
endDate: string
(date-time)
The date and time the cycle ends.
-
mode(required): string
The ending type mode for a product. Can be one of the following:
- absolute: The end date is a calendar day.
- relativeToStart: The end date is relative to the start date, such as a specified number of billing cycles, months, days, hours, minutes, or seconds after the start date.
- never: There is no set end date.
-
unitSettings: object
RelativeSettings
Nested Schema : StartingType
Type:
Show Source
object
-
mode(required): string
The starting type mode for a product. Can be one of the following:
- immediately: The start date is set to today. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
- absolute: The start date is a calendar date. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
- relativeToPurchase: The start date is relative to the purchase date, such as a specified number of billing cycles, months, days, hours, minutes, or seconds after activation. This mode can be used with the cycleStart and usageStart parameters.
- firstUsage: The start day is the day of the first recorded usage.
-
startDate: string
(date-time)
The date and time the cycle starts.
-
unitSettings: object
RelativeSettings
Nested Schema : RelativeSettings
Type:
Show Source
object
-
offset: integer
(int32)
The number of days, hours, minutes or so on after the cycle starts or ends.
-
units(required): string
The offset unit. Can be one of the following:
- seconds
- minutes
- hours
- days
- months
- cycles
Nested Schema : overriddenCharges
Type:
Show Source
object
-
charges(required): array
charges
The charge details.
-
event(required): string
The event associated with the overridden charges.
Nested Schema : charges
Type:
array
The charge details.
Show Source
-
Array of:
object Charges
The charge details.
Nested Schema : Charges
Type:
object
The charge details.
Show Source
-
charge(required): array
charge
The charges.
-
endDate: string
(date-time)
The date and time the charge's validity ends.
-
startDate(required): string
(date-time)
The date and time the charge's validity starts.
Nested Schema : Charge
Type:
object
The charges.
Show Source
-
amount(required): number
The charge amount.
-
priceTag(required): string
The charge's price tag.
-
type(required): string
The charge type.
Nested Schema : CustomizedDiscountOffers
Type:
object
The list of customized discount offers.
Show Source
-
baseDiscountOfferRef: object
ResourceRef
-
cycleEnd: object
EndingType
-
cycleStart: object
StartingType
-
description: string
The discount offer's description.
-
name: string
The discount offer's name.
-
overriddenCharges: array
overriddenCharges
The overridden charges.
-
purchaseEnd: object
EndingType
-
purchaseStart: object
StartingType
-
quantity: integer
(int32)
The discount's quantity.
-
status: integer
(int32)
The discount offer's status. Can be one of the following:
- 0: Not set
- 1: Active
- 2: Inactive
- 3: Canceled
-
statusFlag: integer
(int32)
The status flag.
-
usageEnd: object
EndingType
-
usageStart: object
StartingType
Nested Schema : comments
Type:
array
The list of comments associated with the note.
Show Source
-
Array of:
object Comments
The list of comments associated with the note.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : Comments
Type:
object
The list of comments associated with the note.
Show Source
-
comment(required): string
The comment.
-
csrAccountId: string
The CSR's account ID.
-
csrFirstName: string
The CSR's first name.
-
csrLastName: string
The CSR's last name.
-
csrLoginId: string
The login ID associated with the CSR.
-
entryDate: string
(date-time)
The date and time the comment was entered by the CSR.
-
externalUser: string
The external user.
-
trackingId: string
The tracking ID.
Nested Schema : Discriminator: @class
Type:
Show Source
object
-
accountObj: object
ResourceRef
-
creationDate: string
(date-time)
The date and time the profile was created.
-
effectiveDate: string
(date-time)
The date and time the profile is effective from.
-
extension: object
extension
The extended attributes.
-
id: object
ResourceRef
-
multiValued: boolean
Whether the profile has multiple values (true) or not (false).
-
name: string
The name of the profile.
-
parentName: string
The name of the parent profile.
-
selected: boolean
Whether the profile is selected (true) or not (false).
-
serviceObj: object
ResourceRef
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : PurchasingService
Type:
Show Source
object
-
balanceGroupRef: object
ResourceRef
-
balGrpIndex: integer
(int32)
The balance group index.
-
customizedBundles: array
customizedBundles
-
devices: array
devices
The list of devices associated with the service.
-
groupParent: boolean
Whether this is a parent in a service group (true) or not (false).
-
profiles: array
profiles
-
service: object
Discriminator: @class
Discriminator:
{ "propertyName":"@class" }
-
serviceKey(required): string
The service key.
-
serviceType: string
The service type.
-
subscriptionIndex: integer
(int32)
The subscription index.
Nested Schema : devices
Type:
array
The list of devices associated with the service.
Show Source
-
Array of:
object Devices
The list of devices associated with the service.
Nested Schema : profiles
Type:
Show Source
array
-
Array of:
object Discriminator: @class
Discriminator:
{ "propertyName":"@class" }
Nested Schema : Discriminator: @class
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
aliasList: array
aliasList
The list of aliases associated with the service.
-
balanceGroupRef: object
ResourceRef
-
balGrpIndex: integer
(int32)
The balance group index.
-
creationDate: string
(date-time)
The date and time the service type was created.
-
effectiveDate: string
(date-time)
-
extension: object
extension
The extended attributes.
-
id: object
ResourceRef
-
lastModified: string
(date-time)
The date and time the service was last modified.
-
lastStatusChange: string
(date-time)
The date and time of the last status change.
-
lastStatusComment: string
The comment associated with the last status change.
-
lifeCycleState: integer
(int32)
The current life cycle state.
-
login(required): string
The login associated with the service.
-
name: string
The name of the service.
-
password(required): string
The password associated with the service.
-
passwordExpiration: string
(date-time)
The date and time the password expires.
-
passwordStatus: integer
(int32)
The current status of the password.
-
pendingDeferredActionsCount: integer
(int32)
The number of deferred actions that are pending for the service.
-
serviceAccessLevel: string
The service access level.
-
status: integer
(int32)
The status.
-
statusFlags: integer
(int32)
The status flags.
-
subscriptionServiceRef: object
ResourceRef
Nested Schema : Devices
Type:
object
The list of devices associated with the service.
Show Source
-
description: string
A device's description.
-
id(required): string
The device ID.
Nested Schema : aliasList
Type:
array
The list of aliases associated with the service.
Show Source
-
Array of:
object AliasList
The list of aliases associated with the service.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : PaymentInstrumentType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : extension
Type:
object
The extended attributes.
The data for an account. The minimum required parameters are:
- contacts
- address
- city
- country
- firstName
- lastName
Root Schema : schema
Type:
Show Source
object
-
billUnits: array
billUnits
-
businessType: integer
(int32)
The business type: consumer (1) or business (2).
-
contacts(required): array
contacts
An account's contact information.
-
currency: integer
(int32)
The account's primary currency.
-
customerTypeCode: integer
(int32)
The customer type: standard (1), brand (2), or subscription (3).
-
effective: string
(date-time)
The date and time the account takes effect.
-
extension: object
extension
The extended attributes.
-
genericBundle: object
CustomizedBundleForPurchase
-
locale: string
The customer's locale, such as en_US or fr_FR. For a list of valid values, see "Locale Names" in BRM Developer's Guide.
-
notes: object
Notes
-
organizationHierarchyTypeCode: integer
(int32)
The code for the account organization hierarchy type, such as site or legal entity.
-
parentRef: object
ResourceRef
-
paymentMethod: array
paymentMethod
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10000:Prepaid
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
-
profiles: array
profiles
-
purchasingPlanRef: string
The resource for the purchased package, such as 0.0.0.1+-plan+45678.
-
securityCode1: string
A security code used to verify account access. This provides an authentication test for customer service requests.
-
securityCode2: string
A security code used to verify account access. This provides an authentication test for customer service requests.
-
services(required): array
services
-
status: string
The account's status: active (10100), inactive (10102), or closed (10103).
-
timezoneId: string
The ID for the customer's timezone.
-
wallet: object
Wallet
Nested Schema : contacts
Type:
array
An account's contact information.
Show Source
-
Array of:
object contacts
An account's contact information.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : CustomizedBundleForPurchase
Type:
Show Source
object
-
creditLimitFlags: integer
(int32)
Flag to set credit limit options. Allowed Values: 1 (Override credit limit), 2 (Prorate based on credit limit), 64 (Enforce credit limit).
-
customizedChargeOffers: array
customizedChargeOffers
The list of customized charge offers in the bundle.
-
customizedDiscountOffers: array
customizedDiscountOffers
The list of customized discount offers.
-
effective: string
(date-time)
The date and time the bundle takes effect.
-
extension: object
extension
The extended attributes.
-
id(required): string
The ID.
-
name(required): string
The bundle's name.
-
notes: object
Notes
Nested Schema : Notes
Type:
Show Source
object
-
accountId(required): string
The ID of the account associated with the note.
-
amount: number
The amount associated with the note. It can be a payment amount, adjustment amount, or so on.
-
billId: string
The ID of the bill associated with the note.
-
billUnitId: string
The ID of the bill unit associated with the note.
-
closedDate: string
(date-time)
The date and time the note was resolved.
-
comments: array
comments
The list of comments associated with the note.
-
count: integer
(int32)
The number of comments associated with the note.
-
domainId: integer
(int32)
The domain ID associated with the note.
-
effectiveDate: string
(date-time)
The date and time the comment was posted.
-
eventId: string
The ID of the event associated with the note.
-
extension: object
extension
The extended attributes.
-
header: string
The header associated with the note.
-
id: string
The ID.
-
itemId: string
The ID of the item associated with the note.
-
reasonId: integer
(int32)
The reason ID associated with the note. Possible values are stored in /config/reason_code_scope objects. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the reasons.locale file.
-
serviceId: string
The service ID associated with the note.
-
status: number
The note's status: not set (100), resolved (101), or unresolved (102). The default value is 102.
-
subType: integer
(int32)
The note's subtype. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.
-
type: integer
(int32)
The note's type. Possible values are stored in the /config/note_type object. See Localizing and Customizing Strings in BRM Developer's Guide for information about how to customize these values using the note.locale file.
Nested Schema : ResourceRef
Type:
Show Source
object
-
id(required): string
The ID.
-
uri: string
The Uniform Resource Identifier (URI) associated with the resource.
Nested Schema : profiles
Type:
Show Source
array
-
Array of:
object Discriminator: @class
Discriminator:
{ "propertyName":"@class" }
Nested Schema : Wallet
Type:
Show Source
object
-
extension: object
extension
The extended attributes.
-
paymentInstrument: array
paymentInstrument
Nested Schema : NewBillUnits
Type:
Show Source
object
-
accountingCycleDom: integer
(int32)
The accounting cycle day of month (DOM).
-
accountingType: integer
(int32)
The accounting type. Can be one of the following:
- 1: Open item
- 2: Balance forward
-
arBillUnitRef: object
ResourceRef
-
balanceGroups: array
balanceGroups
-
billingFrequencyInMonths: integer
(int32)
The billing frequency in number of months. Can be one of the following:
- 1: Monthly
- 2: Bi-monthly
- 3: Quarterly
- 12: Yearly
-
businessProfile(required): string
The business profile associated with bill unit.
-
currency: integer
(int32)
The primary currency of the bill unit.
-
effectiveDate: string
(date-time)
The date and time the bill unit takes effect.
-
forServiceGroup(required): array
forServiceGroup
-
name: string
The name of the bill unit.
-
parentBillUnitRef: object
ResourceRef
-
parentRef: string
A reference to the parent.
-
paymentMethod: object
PaymentMethod
-
paymentMethodId: string
The ID of the payment method.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
-
rollUp: boolean
-
segment: integer
(int32)
The customer segment associated with the bill unit. A customer segment is a user-defined customer description that can be used to group accounts according to customer billing and payment practices.
-
status: string
The status of the bill unit, such as active, inactive, or closed.
-
walletPaymentInstrumentIndex: integer
(int32)
The wallet index number for the payment instrument associated with the bill unit.
Nested Schema : PaymentMethod
Type:
Show Source
object
-
creditCard: object
CreditCardType
-
directDebit: object
DirectDebitType
-
extension: object
extension
The extended attributes.
-
invoice: object
InvoiceType
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
-
sepa: object
SepaType
Nested Schema : BalanceGroup
Type:
Show Source
object
-
balances: array
balances
The list of balances associated with the balance group.
-
elem: integer
(int32)
The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
-
extension: object
extension
The extended attributes.
-
id(required): string
The ID.
-
monitorType: string
The monitoring group type. Allowed Values:
- H_CE (Hierarchy Credit Exposure)
- PR_CE (Payment Responsible Credit Exposure)
- SUB_CE (Subscription Credit Exposure)
- PR_RTCE (Payment Responsible Real-Time Credit Enforcement)
-
name: string
The name of the balance group.
-
services: array
services
Nested Schema : balances
Type:
array
The list of balances associated with the balance group.
Show Source
-
Array of:
object Balances
The list of balances associated with the balance group.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : Balances
Type:
object
The list of balances associated with the balance group.
Show Source
-
creditFloor: number
The credit floor associated with the balance.
-
creditLimit: number
The credit limit associated with the balance.
-
creditThresholds: integer
(int32)
The credit thresholds associated with the balance.
-
creditThresholdsFixed: string
The value at which to send a notification, such as 30 US dollars or 30 minutes.
-
currentBalance(required): number
The current balance.
-
dynamicCreditFloor: boolean
Whether to use a dynamic credit floor (true) or not (false). The default is false.
-
expiredBeforeUsing: number
The number of days until the balance expires.
-
formattedCreditThresholds: string
The balance percentage usage at which to notify the customer.
-
loanThresholds: integer
(int32)
The percent-based threshold for offering a loan. If the customer's balance falls below this percent, they are notified and offered a loan.
-
loanThresholdsFixed: string
The fixed amount threshold for offering a loan. If the customer's balance falls below this amount, they are notified and offered a loan.
-
modifyLimit: boolean
Whether a credit limit is being modified by the request (true) or not (false).
-
outstandingAmount(required): number
An amount that the customer still owes, for loans or when they exceed their credit limit.
-
overrideCreditLimit: integer
(int32)
Whether to override the credit limit. Allowed Values: 0 (Enforce Credit Limit) or 1 (Override credit limit).
-
resourceId: integer
(int32)
The resource ID associated with the balance.
-
subBalances: array
subBalances
-
tempCreditLimit: array
tempCreditLimit
Nested Schema : SubBalances
Type:
Show Source
object
-
currentBalance: number
The current amount of the sub-balance.
-
elementId: integer
(int32)
The ID of the element.
-
expiredBeforeUsing: number
The number of days until the sub-balance expires.
-
extension: object
extension
The extended attributes.
-
rolloverData: integer
(int32)
Details about a rollover subbalance.
-
validFrom: string
(date-time)
The date and time the validity period starts.
-
validTo: string
(date-time)
The date and time the validity period ends.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : TempCreditLimit
Type:
Show Source
object
-
extension: object
extension
The extended attributes.
-
limit: number
The temporary credit limit amount.
-
resourceId: integer
(int32)
The resource ID associated with the temporary credit limit.
-
validFrom(required): string
(date-time)
The date and time temporary credit limit's validity starts.
-
validFromOffset: integer
(int32)
The offset for the temporary credit limit's validity period start.
-
validFromUnit: integer
(int32)
The unit for the temporary credit limit's validity period start.
-
validTo(required): string
(date-time)
The date and time temporary credit limit's validity ends.
-
validToOffset: integer
(int32)
The offset for the temporary credit limit's validity period end.
-
validToUnit: integer
(int32)
The unit for the temporary credit limit's validity period end.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : ServiceType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
aliasList: array
aliasList
The list of aliases associated with the service.
-
balanceGroupRef: object
ResourceRef
-
balGrpIndex: integer
(int32)
The balance group index.
-
creationDate: string
(date-time)
The date and time the service type was created.
-
effectiveDate: string
(date-time)
-
extension: object
extension
The extended attributes.
-
id: object
ResourceRef
-
lastModified: string
(date-time)
The date and time the service was last modified.
-
lastStatusChange: string
(date-time)
The date and time of the last status change.
-
lastStatusComment: string
The comment associated with the last status change.
-
lifeCycleState: integer
(int32)
The current life cycle state.
-
login(required): string
The login associated with the service.
-
name: string
The name of the service.
-
password(required): string
The password associated with the service.
-
passwordExpiration: string
(date-time)
The date and time the password expires.
-
passwordStatus: integer
(int32)
The current status of the password.
-
pendingDeferredActionsCount: integer
(int32)
The number of deferred actions that are pending for the service.
-
serviceAccessLevel: string
The service access level.
-
status: integer
(int32)
The status.
-
statusFlags: integer
(int32)
The status flags.
-
subscriptionServiceRef: object
ResourceRef
Nested Schema : aliasList
Type:
array
The list of aliases associated with the service.
Show Source
-
Array of:
object AliasList
The list of aliases associated with the service.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : ServiceGroupIndex
Type:
Show Source
object
-
serviceGroupElem: integer
(int32)
The service group element.
Nested Schema : CreditCardType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : DirectDebitType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : InvoiceType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : SepaType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
details: object
Details
The offer details.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : Details
Type:
object
The offer details.
Show Source
-
balanceImpactResource(required): string
The resource that represents the balance impact of the offer.
-
fixedAmount: number
(float)
The fixed amount of the offer.
-
fixedPriceTag(required): string
The fixed price tag of the offer.
-
scaledAmount: number
(float)
The scaled amount of the offer.
-
scaledPriceTag(required): string
The scaled price tag of the offer.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : contacts
Type:
object
An account's contact information.
Show Source
-
address(required): string
The customer's address.
-
city(required): string
The customer's city.
-
company: string
The company name.
-
contactType: string
The contact type.
-
country(required): string
The customer's country.
-
deleted: boolean
Default Value:
false
Whether to delete the contact (true) or not (false). This must be set to false if you adding a contact. -
elem: integer
(int32)
The position of the entry in the array. For example, the first item in a list would have an elem value of 1.
-
emailAddress: string
The customer's email address.
-
firstName(required): string
The customer's first name.
-
lastName(required): string
The customer's last name.
-
middleName: string
The customer's middle name.
-
newlyCreated: boolean
Default Value:
false
Whether the contact information was newly created (true) or not (false). -
phonenumbers: array
phonenumbers
The list of associated phone numbers.
-
salutation: string
The salutation to use use with the customer, such as Mr. or Miss.
-
state: string
The customer's state.
-
title: string
The customer's job title.
-
zip: string
The ZIP code.
Nested Schema : phonenumbers
Type:
array
The list of associated phone numbers.
Show Source
-
Array of:
object Phonenumbers
The list of the account's phone numbers.
Nested Schema : Phonenumbers
Type:
object
The list of the account's phone numbers.
Show Source
-
number(required): string
The phone number.
-
phonetype: integer
(int32)
The phone number's type.
Nested Schema : customizedChargeOffers
Type:
array
The list of customized charge offers in the bundle.
Show Source
-
Array of:
object CustomizedChargeOffers
The list of customized charge offers in the bundle.
Nested Schema : customizedDiscountOffers
Type:
array
The list of customized discount offers.
Show Source
-
Array of:
object CustomizedDiscountOffers
The list of customized discount offers.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : CustomizedChargeOffers
Type:
object
The list of customized charge offers in the bundle.
Show Source
-
baseChargeOfferRef: object
ResourceRef
-
baseProductRef: object
ResourceRef
-
cycleDiscountOverride: number
The fixed amount of the cycle discount override.
-
cycleDiscountPercentOverride: number
The percentage amount of the cycle discount override.
-
cycleEnd: object
EndingType
-
cycleFeeOverride: number
The amount of the cycle fee override.
-
cycleStart: object
StartingType
-
description: string
The charge offer's description.
-
gracePeriodOffset: integer
(int32)
The number to offset the grace period by.
-
gracePeriodUnit: integer
(int32)
The unit for the grace period.
-
name: string
The charge offer's name.
-
overriddenCharges: array
overriddenCharges
The overridden charges.
-
purchaseDiscountOverride: number
The fixed amount of the purchase discount override.
-
purchaseDiscountPercentOverride: number
The percentage amount of the purchase discount override.
-
purchaseEnd: object
EndingType
-
purchaseFeeOverride: number
The fixed amount of the purchase fee override.
-
purchaseStart: object
StartingType
-
quantity: integer
(int32)
The quantity purchased.
-
renewalMode: integer
(int32)
How to handle the charge offer's cycle alignment when its bundle is reactivated. Possible values are:
- 0: Cycle aligns with the original billing date or configured specific day of the month.
- 1: Cycle aligns with the reactivation date.
-
status: integer
(int32)
The charge offer's status. Can be one of the following:
- 0: Not set
- 1: Active
- 2: Inactive
- 3: Canceled
-
statusFlag: integer
(int32)
The status flag.
-
usageEnd: object
EndingType
-
usagePercentOverride: number
The percentage amount of the usage override.
-
usageStart: object
StartingType
-
validityAlignMode: string
The validity align mode for a product. Can be one of the following:
- base: Align the validity with baseProductRef passed in request
- any_base_earliest: Aligns the validity dates with the active base charge offer that expires first.
- any_base_latest: Aligns the validity dates with the active base charge offer that expires last.
- any_earliest: Aligns the validity dates with the active charge offer that expires first.
- any_latest: Aligns the validity dates with the active charge offer that expires last.
Nested Schema : EndingType
Type:
Show Source
object
-
endDate: string
(date-time)
The date and time the cycle ends.
-
mode(required): string
The ending type mode for a product. Can be one of the following:
- absolute: The end date is a calendar day.
- relativeToStart: The end date is relative to the start date, such as a specified number of billing cycles, months, days, hours, minutes, or seconds after the start date.
- never: There is no set end date.
-
unitSettings: object
RelativeSettings
Nested Schema : StartingType
Type:
Show Source
object
-
mode(required): string
The starting type mode for a product. Can be one of the following:
- immediately: The start date is set to today. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
- absolute: The start date is a calendar date. This mode can be used with the purchaseStart, cycleStart, and usageStart parameters.
- relativeToPurchase: The start date is relative to the purchase date, such as a specified number of billing cycles, months, days, hours, minutes, or seconds after activation. This mode can be used with the cycleStart and usageStart parameters.
- firstUsage: The start day is the day of the first recorded usage.
-
startDate: string
(date-time)
The date and time the cycle starts.
-
unitSettings: object
RelativeSettings
Nested Schema : RelativeSettings
Type:
Show Source
object
-
offset: integer
(int32)
The number of days, hours, minutes or so on after the cycle starts or ends.
-
units(required): string
The offset unit. Can be one of the following:
- seconds
- minutes
- hours
- days
- months
- cycles
Nested Schema : overriddenCharges
Type:
Show Source
object
-
charges(required): array
charges
The charge details.
-
event(required): string
The event associated with the overridden charges.
Nested Schema : charges
Type:
array
The charge details.
Show Source
-
Array of:
object Charges
The charge details.
Nested Schema : Charges
Type:
object
The charge details.
Show Source
-
charge(required): array
charge
The charges.
-
endDate: string
(date-time)
The date and time the charge's validity ends.
-
startDate(required): string
(date-time)
The date and time the charge's validity starts.
Nested Schema : Charge
Type:
object
The charges.
Show Source
-
amount(required): number
The charge amount.
-
priceTag(required): string
The charge's price tag.
-
type(required): string
The charge type.
Nested Schema : CustomizedDiscountOffers
Type:
object
The list of customized discount offers.
Show Source
-
baseDiscountOfferRef: object
ResourceRef
-
cycleEnd: object
EndingType
-
cycleStart: object
StartingType
-
description: string
The discount offer's description.
-
name: string
The discount offer's name.
-
overriddenCharges: array
overriddenCharges
The overridden charges.
-
purchaseEnd: object
EndingType
-
purchaseStart: object
StartingType
-
quantity: integer
(int32)
The discount's quantity.
-
status: integer
(int32)
The discount offer's status. Can be one of the following:
- 0: Not set
- 1: Active
- 2: Inactive
- 3: Canceled
-
statusFlag: integer
(int32)
The status flag.
-
usageEnd: object
EndingType
-
usageStart: object
StartingType
Nested Schema : comments
Type:
array
The list of comments associated with the note.
Show Source
-
Array of:
object Comments
The list of comments associated with the note.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : Comments
Type:
object
The list of comments associated with the note.
Show Source
-
comment(required): string
The comment.
-
csrAccountId: string
The CSR's account ID.
-
csrFirstName: string
The CSR's first name.
-
csrLastName: string
The CSR's last name.
-
csrLoginId: string
The login ID associated with the CSR.
-
entryDate: string
(date-time)
The date and time the comment was entered by the CSR.
-
externalUser: string
The external user.
-
trackingId: string
The tracking ID.
Nested Schema : Discriminator: @class
Type:
Show Source
object
-
accountObj: object
ResourceRef
-
creationDate: string
(date-time)
The date and time the profile was created.
-
effectiveDate: string
(date-time)
The date and time the profile is effective from.
-
extension: object
extension
The extended attributes.
-
id: object
ResourceRef
-
multiValued: boolean
Whether the profile has multiple values (true) or not (false).
-
name: string
The name of the profile.
-
parentName: string
The name of the parent profile.
-
selected: boolean
Whether the profile is selected (true) or not (false).
-
serviceObj: object
ResourceRef
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : PurchasingService
Type:
Show Source
object
-
balanceGroupRef: object
ResourceRef
-
balGrpIndex: integer
(int32)
The balance group index.
-
customizedBundles: array
customizedBundles
-
devices: array
devices
The list of devices associated with the service.
-
groupParent: boolean
Whether this is a parent in a service group (true) or not (false).
-
profiles: array
profiles
-
service: object
Discriminator: @class
Discriminator:
{ "propertyName":"@class" }
-
serviceKey(required): string
The service key.
-
serviceType: string
The service type.
-
subscriptionIndex: integer
(int32)
The subscription index.
Nested Schema : devices
Type:
array
The list of devices associated with the service.
Show Source
-
Array of:
object Devices
The list of devices associated with the service.
Nested Schema : profiles
Type:
Show Source
array
-
Array of:
object Discriminator: @class
Discriminator:
{ "propertyName":"@class" }
Nested Schema : Discriminator: @class
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
aliasList: array
aliasList
The list of aliases associated with the service.
-
balanceGroupRef: object
ResourceRef
-
balGrpIndex: integer
(int32)
The balance group index.
-
creationDate: string
(date-time)
The date and time the service type was created.
-
effectiveDate: string
(date-time)
-
extension: object
extension
The extended attributes.
-
id: object
ResourceRef
-
lastModified: string
(date-time)
The date and time the service was last modified.
-
lastStatusChange: string
(date-time)
The date and time of the last status change.
-
lastStatusComment: string
The comment associated with the last status change.
-
lifeCycleState: integer
(int32)
The current life cycle state.
-
login(required): string
The login associated with the service.
-
name: string
The name of the service.
-
password(required): string
The password associated with the service.
-
passwordExpiration: string
(date-time)
The date and time the password expires.
-
passwordStatus: integer
(int32)
The current status of the password.
-
pendingDeferredActionsCount: integer
(int32)
The number of deferred actions that are pending for the service.
-
serviceAccessLevel: string
The service access level.
-
status: integer
(int32)
The status.
-
statusFlags: integer
(int32)
The status flags.
-
subscriptionServiceRef: object
ResourceRef
Nested Schema : Devices
Type:
object
The list of devices associated with the service.
Show Source
-
description: string
A device's description.
-
id(required): string
The device ID.
Nested Schema : aliasList
Type:
array
The list of aliases associated with the service.
Show Source
-
Array of:
object AliasList
The list of aliases associated with the service.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : extension
Type:
object
The extended attributes.
Nested Schema : PaymentInstrumentType
Type:
Show Source
object
-
accountRef: object
ResourceRef
-
correctiveInvoiceType: integer
(int32)
The type of invoice to create, such as an invoice correction letter or a replacement invoice.
-
extension: object
extension
The extended attributes.
-
id: string
The ID.
-
name: string
The payment instrument's name.
-
paymentType: integer
(int32)
The payment type. Can be one of the following:
- 10001:Invoice
- 10003: Credit card
- 10005: Direct debit
- 10007: Subordinate
Nested Schema : extension
Type:
object
The extended attributes.
Response
200 Response
The account data was validated successfully.
500 Response
An internal server error occurred.
Examples
This example shows how to validate the registration data for an account by submitting a POST request on the REST resource using cURL. For more information about cURL, see "Use cURL".
cURL Command
curl -X POST 'http://hostname:port/bcws/webresources/version/accounts/validate' -H 'content-type: application/json' -d @validate.json
where:
- hostname is the URL for the Billing Care REST server.
- port is the port for the Billing Care REST server.
- version is the version of the API you're using, such as v1.0.
- validate.json is the JSON file that specifies the account content to validate.
Example of Request Body
This example shows the contents of the validate.json file sent as the request body.
{
"locale": "en_US",
"customerTypeCode": "",
"organizationHierarchyTypeCode": "-1",
"securityCode1": "question",
"securityCode2": "answer",
"contacts": [
{
"firstName": "Emelia",
"lastName": "Jackson",
"middleName": "Sue",
"salutation": "Ms.",
"address": "2300 Oracle Way",
"city": "Austin",
"company": "Vision Corporation",
"emailAddress": "email@example.com",
"state": "TX",
"zip": "78741",
"deleted": false,
"newlyCreated": true,
"elem": 1,
"contactType": "Work",
"country": "US",
"phonenumbers": []
}
]
}
Example of Response Body
If the account information is valid, the response code 200 is returned with true in the response body.