REST Services Manager API for Billing and Revenue Management

Get Payments

get

/payment

Gets the payments that match the specified query criteria.

Request

Query Parameters

@type: string
The type of object to return. Use @type=Payment for a base object, or @type=PaymentOracle for an extended object.
Example:
```
Payment
```
account.id: string
Retrieves the payments from the account with the specified ID or account number.
Example:
```
0.0.0.1+-account+79731
```
fields: string
The comma-separated list of fields to return in the response.
Example:
```
paymentDate,account
```
id: string
Retrieves the payment with the specified ID.
Example:
```
0.0.0.1+-item-payment+106589
```
limit: integer
The maximum number of results to return. For example, use limit=10 to return the first 10 results only.
Example:
```
10
```
offset: integer
The number of results to offset the response by. For example, use offset=10 to return results 10 and higher.
Example:
```
10
```
paymentDate: string
Retrieves the payments with a paymentDate that matches the specified dateTime.
Example:
```
2020-01-01T12:00:27.000Z
```
paymentDate.gt: string
Retrieves the payments with a paymentDate that is greater than the specified dateTime.
Example:
```
2020-01-01T12:00:27.000Z
```
paymentDate.gte: string
Retrieves the payments with a paymentDate that is greater than or equal to the specified dateTime.
Example:
```
2020-01-01T12:00:27.000Z
```
paymentDate.lt: string
Retrieves the payments with a paymentDate that is less than the specified dateTime.
Example:
```
2020-01-01T12:00:27.000Z
```
paymentDate.lte: string
Retrieves the payments with a paymentDate that is less than or equal to the specified dateTime.
Example:
```
2020-01-01T12:00:27.000Z
```
status: string
Retrieves the payments with the specified status. The only valid value is status=Unallocated.
Example:
```
Unallocated
```
totalAmount.value: number(float)
Retrieves the payments with a totalAmount that is equal to the specified amount.
Example:
```
40
```
totalAmount.value.gt: number(float)
Retrieves the payments with a totalAmount that is greater than the specified amount.
Example:
```
40
```
totalAmount.value.gte: number(float)
Retrieves the payments with a totalAmount that is greater than or equal to the specified amount.
Example:
```
40
```
totalAmount.value.lt: number(float)
Retrieves the payments with a totalAmount that is less than the specified amount.
Example:
```
40
```
totalAmount.value.lte: number(float)
Retrieves the payments with a totalAmount that is less than or equal to the specified amount.
Example:
```
40
```

There's no request body for this operation.

Response

Supported Media Types

application/json;charset=utf-8

200 Response

Success

Headers

X-Result-Count(required):

The number of items returned in the response body.
X-Total-Count(required):

The total number of items that matched the criteria.

Root Schema : schema

Type: array

Show Source

Array of: object Payment

Title: Payment

A payment, including information about the payment, the payment amount, and the payment method.

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Payment"
    }
}

Nested Schema : Payment

Type: object

Title: Payment

A payment, including information about the payment, the payment amount, and the payment method.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
account(required): object object Account Ref

Title: Account Ref

A reference to an account.
amount: object object Money

Title: Money

An amount of money.
authorizationCode: string

Title: Authorization code

An authorization code from an external payment gateway.
channel: object object ChannelRef

A reference to a channel.
correlatorId: string

Title: correlator ID

An payment correlation ID from a client application.
description: string

Title: Payment Description

The payment's description.
href(required): string

Title: Payment Href

The payment's href.
id(required): string

Title: Payment ID

The payment's ID.
name: string

Title: Payment Name

The payment's name.
payer: object object Related Party

Title: Related Party

A party related to another object.
paymentDate(required): string (date-time)

Title: Payment Date

The date the payment was made.
paymentItem: array array paymentItem

Payment items which can be assigned to bills.
paymentMethod(required): object object Payment Method Ref Or Value

Title: Payment Method Ref Or Value

A link to the resource containing information about the payment method. For Payment_Create requests, when the value of the payment method's @type property is PaymentMethodRef, the @referredType property is also required, and valid values are tokenizedCard, bankAccountDebit, and bankCard.
status(required): string

Title: Payment Status

The payment's status.
statusDate: string (date-time)

Title: Status Date

The date the payment's status was recorded.
taxAmount: object object Money

Title: Money

An amount of money.
totalAmount(required): object object Money

Title: Money

An amount of money.

{
    "required":[
        "id",
        "href",
        "paymentDate",
        "totalAmount",
        "account",
        "paymentMethod",
        "status"
    ],
    "type":"object",
    "title":"Payment",
    "properties":{
        "id":{
            "type":"string",
            "title":"Payment ID",
            "description":"The payment's ID."
        },
        "href":{
            "type":"string",
            "title":"Payment Href",
            "description":"The payment's href."
        },
        "authorizationCode":{
            "type":"string",
            "title":"Authorization code",
            "description":"An authorization code from an external payment gateway."
        },
        "correlatorId":{
            "type":"string",
            "title":"correlator ID",
            "description":"An payment correlation ID from a client application."
        },
        "description":{
            "type":"string",
            "title":"Payment Description",
            "description":"The payment's description."
        },
        "name":{
            "type":"string",
            "title":"Payment Name",
            "description":"The payment's name."
        },
        "paymentDate":{
            "type":"string",
            "title":"Payment Date",
            "description":"The date the payment was made.",
            "format":"date-time"
        },
        "status":{
            "type":"string",
            "title":"Payment Status",
            "description":"The payment's status."
        },
        "statusDate":{
            "type":"string",
            "title":"Status Date",
            "description":"The date the payment's status was recorded.",
            "format":"date-time"
        },
        "account":{
            "description":"An account related to the payment.",
            "$ref":"#/components/schemas/AccountRef"
        },
        "amount":{
            "description":"The payment's monetary amount.",
            "$ref":"#/components/schemas/Money"
        },
        "channel":{
            "description":"The payment's channel.",
            "$ref":"#/components/schemas/ChannelRef"
        },
        "payer":{
            "description":"The party that made the payment.",
            "$ref":"#/components/schemas/RelatedParty"
        },
        "paymentItem":{
            "type":"array",
            "description":"Payment items which can be assigned to bills.",
            "items":{
                "$ref":"#/components/schemas/PaymentItem"
            }
        },
        "paymentMethod":{
            "description":"The payment method.",
            "$ref":"#/components/schemas/PaymentMethodRefOrValue"
        },
        "taxAmount":{
            "description":"The amount of tax on the payment.",
            "$ref":"#/components/schemas/Money"
        },
        "totalAmount":{
            "description":"The total amount on the payment.",
            "$ref":"#/components/schemas/Money"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "description":"A payment, including information about the payment, the payment amount, and the payment method."
}

Nested Schema : Account Ref

Type: object

Title: Account Ref

A reference to an account.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType: string

Title: Referred Type

The object's type in the target system, if baseType and type need further disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
description: string

Title: Description

The account reference's description.
href: string

Title: Account Href

The account reference's href.
id(required): string

Title: Account ID

The account reference's ID.
name: string

Title: Account Name

The account reference's name.

{
    "required":[
        "id"
    ],
    "type":"object",
    "title":"Account Ref",
    "properties":{
        "id":{
            "type":"string",
            "title":"Account ID",
            "description":"The account reference's ID."
        },
        "href":{
            "type":"string",
            "title":"Account Href",
            "description":"The account reference's href."
        },
        "description":{
            "type":"string",
            "title":"Description",
            "description":"The account reference's description."
        },
        "name":{
            "type":"string",
            "title":"Account Name",
            "description":"The account reference's name."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "description":"A reference to an account."
}

Nested Schema : Money

Type: object

Title: Money

An amount of money.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
unit: string

Title: Currency

An ISO 4217 three letter currency code.
value: number (float)

Title: Amount

A positive floating point number.

{
    "type":"object",
    "title":"Money",
    "properties":{
        "unit":{
            "type":"string",
            "title":"Currency",
            "description":"An ISO 4217 three letter currency code."
        },
        "value":{
            "type":"number",
            "title":"Amount",
            "description":"A positive floating point number.",
            "format":"float"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "description":"An amount of money."
}

Nested Schema : ChannelRef

Type: object

A reference to a channel.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType: string

Title: Referred Type

The object's type in the target system, if baseType and type need further disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
href: string

Title: Channel Href

The channel's href.
id(required): string

Title: Channel ID

The channel's ID.
name: string

Title: Channel Name

The channel's name.

{
    "required":[
        "id"
    ],
    "type":"object",
    "properties":{
        "id":{
            "type":"string",
            "title":"Channel ID",
            "description":"The channel's ID."
        },
        "href":{
            "type":"string",
            "title":"Channel Href",
            "description":"The channel's href."
        },
        "name":{
            "type":"string",
            "title":"Channel Name",
            "description":"The channel's name."
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "description":"A reference to a channel."
}

Nested Schema : Related Party

Type: object

Title: Related Party

A party related to another object.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType(required): string

Title: Referred Type

The object's type in the target system, if baseType and type need further disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
href: string (uri)

Title: Href

The party's href.
id(required): string

Title: Party ID

The party's ID.
name: string

Title: Party Name

The party's name.
role: string

Title: Party Role

The party's role.

{
    "required":[
        "@referredType",
        "id"
    ],
    "type":"object",
    "title":"Related Party",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "href":{
            "type":"string",
            "title":"Href",
            "description":"The party's href.",
            "format":"uri"
        },
        "id":{
            "type":"string",
            "title":"Party ID",
            "description":"The party's ID."
        },
        "name":{
            "type":"string",
            "title":"Party Name",
            "description":"The party's name."
        },
        "role":{
            "type":"string",
            "title":"Party Role",
            "description":"The party's role."
        }
    },
    "description":"A party related to another object."
}

Nested Schema : paymentItem

Type: array

Payment items which can be assigned to bills.

Show Source

Array of: object Payment Item

Title: Payment Item

A portion of a payment that can be assigned to a bill.

{
    "type":"array",
    "description":"Payment items which can be assigned to bills.",
    "items":{
        "$ref":"#/components/schemas/PaymentItem"
    }
}

Nested Schema : Payment Method Ref Or Value

Type: object

Title: Payment Method Ref Or Value

A link to the resource containing information about the payment method. For Payment_Create requests, when the value of the payment method's @type property is PaymentMethodRef, the @referredType property is also required, and valid values are tokenizedCard, bankAccountDebit, and bankCard.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType: string

Title: Referred Type

The object's type in the target system, if baseType and type need further disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type(required): string

Title: Type

The payment method's type. Valid values are PaymentMethodRef for a credit or debit card, Cash, or Check. When the value is PaymentMethodRef, the payment method specified must be the one assigned to the bill unit. If you specify a different payment method, the one assigned to the bill unit will be refunded instead. (For payments and refunds, @type is not used for subclassing.)
account: array array account

Accounts associated with the payment method.
description: string

Title: Payment Method Description

The payment method's description.
href: string

Title: Payment Method Href

The payment method's href.
id(required): string

Title: Payment Method ID

The payment method's ID.
isPreferred: boolean

Title: Payment Method Preferred

Whether this is the preferred payment method (true) or not (false).
name: string

Title: Payment Method Name

The payment method's name.
relatedParty: object object Related Party

Title: Related Party

A party related to another object.
status: string

Title: Status

The payment method's status.
statusDate: string (date-time)

Title: Status Date

The date the payment method's status was recorded.
validFor: object object Time Period

Title: Time Period

A period of time. You can specify only endDateTime or both endDateTime and startDateTime.

{
    "type":"object",
    "title":"Payment Method Ref Or Value",
    "properties":{
        "id":{
            "type":"string",
            "title":"Payment Method ID",
            "description":"The payment method's ID."
        },
        "href":{
            "type":"string",
            "title":"Payment Method Href",
            "description":"The payment method's href."
        },
        "description":{
            "type":"string",
            "title":"Payment Method Description",
            "description":"The payment method's description."
        },
        "isPreferred":{
            "type":"boolean",
            "title":"Payment Method Preferred",
            "description":"Whether this is the preferred payment method (<b>true</b>) or not (<b>false</b>)."
        },
        "name":{
            "type":"string",
            "title":"Payment Method Name",
            "description":"The payment method's name."
        },
        "status":{
            "type":"string",
            "title":"Status",
            "description":"The payment method's status."
        },
        "statusDate":{
            "type":"string",
            "title":"Status Date",
            "description":"The date the payment method's status was recorded.",
            "format":"date-time"
        },
        "account":{
            "type":"array",
            "description":"Accounts associated with the payment method.",
            "items":{
                "$ref":"#/components/schemas/AccountRef"
            }
        },
        "relatedParty":{
            "description":"The party associated with the payment method.",
            "$ref":"#/components/schemas/RelatedParty"
        },
        "validFor":{
            "description":"The time period for which the payment method is valid.",
            "$ref":"#/components/schemas/TimePeriod"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The payment method's type. Valid values are <b>PaymentMethodRef</b> for a credit or debit card, <b>Cash</b>, or <b>Check</b>. When the value is <b>PaymentMethodRef</b>, the payment method specified must be the one assigned to the bill unit. If you specify a different payment method, the one assigned to the bill unit will be refunded instead. (For payments and refunds, @type is not used  for subclassing.)"
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        }
    },
    "description":"A link to the resource containing information about the payment method. For Payment_Create requests, when the value of the payment method's <b>@type</b> property is <b>PaymentMethodRef</b>, the <b>@referredType</b> property is also required, and valid values are <b>tokenizedCard</b>, <b>bankAccountDebit</b>, and <b>bankCard</b>.",
    "required":[
        "id",
        "@type"
    ]
}

Nested Schema : Payment Item

Type: object

Title: Payment Item

A portion of a payment that can be assigned to a bill.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON-Schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
amount: object object Money

Title: Money

An amount of money.
id: string

Title: Payment Item ID

The payment item's ID.
item(required): object object Entity Ref

Title: Entity Ref

An entity reference schema.
taxAmount: object object Money

Title: Money

An amount of money.
totalAmount: object object Money

Title: Money

An amount of money.

{
    "required":[
        "item"
    ],
    "type":"object",
    "title":"Payment Item",
    "properties":{
        "id":{
            "type":"string",
            "title":"Payment Item ID",
            "description":"The payment item's ID."
        },
        "amount":{
            "description":"The payment item amount.",
            "$ref":"#/components/schemas/Money"
        },
        "item":{
            "description":"A payment item entity.",
            "$ref":"#/components/schemas/EntityRef"
        },
        "taxAmount":{
            "description":"The amount of tax on the payment item.",
            "$ref":"#/components/schemas/Money"
        },
        "totalAmount":{
            "description":"The total amount on the payment item.",
            "$ref":"#/components/schemas/Money"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON-Schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "description":"A portion of a payment that can be assigned to a bill."
}

Nested Schema : Entity Ref

Type: object

Title: Entity Ref

An entity reference schema.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@referredType: string

Title: Referred Type

The object's type in the target system, if baseType and type need further disambiguation.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
href: string

Title: Entity Href

The entity's href..
id(required): string (uri)

Title: Entity ID

The entity's ID.
name: string

Title: Entity Name

The entity's name.

{
    "required":[
        "id"
    ],
    "type":"object",
    "title":"Entity Ref",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@referredType":{
            "type":"string",
            "title":"Referred Type",
            "description":"The object's type in the target system, if <b>baseType</b> and <b>type</b> need further disambiguation."
        },
        "id":{
            "type":"string",
            "title":"Entity ID",
            "description":"The entity's ID.",
            "format":"uri"
        },
        "href":{
            "type":"string",
            "title":"Entity Href",
            "description":"The entity's href.."
        },
        "name":{
            "type":"string",
            "title":"Entity Name",
            "description":"The entity's name."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "description":"An entity reference schema."
}

Nested Schema : account

Type: array

Accounts associated with the payment method.

Show Source

Array of: object Account Ref

Title: Account Ref

A reference to an account.

{
    "type":"array",
    "description":"Accounts associated with the payment method.",
    "items":{
        "$ref":"#/components/schemas/AccountRef"
    }
}

Nested Schema : Time Period

Type: object

Title: Time Period

A period of time. You can specify only endDateTime or both endDateTime and startDateTime.

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
endDateTime: string (date-time)

Title: End DateTime

The end of the time period in IETC-RFC-3339 format.

Example: 1985-04-12T23:20:50.520Z
startDateTime: string (date-time)

Title: Start DateTime

The start of the time period in IETC-RFC-3339 format. If you specify this, you must also specify endDateTime.

Example: 1985-04-12T23:20:50.520Z

{
    "type":"object",
    "title":"Time Period",
    "properties":{
        "endDateTime":{
            "type":"string",
            "title":"End DateTime",
            "description":"The end of the time period in IETC-RFC-3339 format.",
            "format":"date-time",
            "example":"1985-04-12T23:20:50.520Z"
        },
        "startDateTime":{
            "type":"string",
            "title":"Start DateTime",
            "description":"The start of the time period in IETC-RFC-3339 format. If you specify this, you must also specify <b>endDateTime</b>.",
            "format":"date-time",
            "example":"1985-04-12T23:20:50.520Z"
        },
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        }
    },
    "description":"A period of time. You can specify only <b>endDateTime</b> or both <b>endDateTime</b> and <b>startDateTime</b>."
}

400 Response

Bad Request

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

401 Response

Unauthorized

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

403 Response

Forbidden

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

404 Response

Not Found

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

405 Response

Method Not allowed

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

409 Response

Conflict

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

500 Response

Internal Server Error

Root Schema : Error

Type: object

Title: Error

Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error).

Show Source

@baseType: string

Title: Base Type

The object's superclass.
@schemaLocation: string (uri)

Title: Schema Location

A URI to a JSON schema file that defines additional attributes and relationships.
@type: string

Title: Type

The object's subclass.
code(required): string

Title: Error Code

An error code.
message: string

Title: Error Message

Details and corrective actions related to the error.
reason(required): string

Title: Reason

The reason for the error.
referenceError: string (uri)

Title: Reference Error

A URI to documentation describing the error.
status: string

Title: Error Status

The HTTP Error code extension.

{
    "required":[
        "code",
        "reason"
    ],
    "type":"object",
    "title":"Error",
    "properties":{
        "@baseType":{
            "type":"string",
            "title":"Base Type",
            "description":"The object's superclass."
        },
        "@schemaLocation":{
            "type":"string",
            "title":"Schema Location",
            "description":"A URI to a JSON schema file that defines additional attributes and relationships.",
            "format":"uri"
        },
        "@type":{
            "type":"string",
            "title":"Type",
            "description":"The object's subclass."
        },
        "code":{
            "type":"string",
            "title":"Error Code",
            "description":"An error code."
        },
        "message":{
            "type":"string",
            "title":"Error Message",
            "description":"Details and corrective actions related to the error."
        },
        "reason":{
            "type":"string",
            "title":"Reason",
            "description":"The reason for the error."
        },
        "referenceError":{
            "type":"string",
            "title":"Reference Error",
            "description":"A URI to documentation describing the error.",
            "format":"uri"
        },
        "status":{
            "type":"string",
            "title":"Error Status",
            "description":"The HTTP Error code extension."
        }
    },
    "description":"Used when an API returns an error, typically with a HTTP error response-code such as 401 (Unauthorized) or 500 (Internal Server Error)."
}

Examples

The following example shows how to get payments by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.

The request uses the account.id query parameter to limit the results.

curl -X GET 'http://host:port/brm/payment/version/payment?account.id=0.0.0.1+-account+228862'

Example of the Response Body

The following example shows the contents of the response body in JSON format.

[
    {
        "id": "0.0.0.1+-item-payment+222690",
        "href": "http://host:port/brm/payment/version/payment/0.0.0.1+-item-payment+222690",
        "authorizationCode": "pinXXX",
        "correlatorId": "P1-8",
        "description": "Credit Card Payment",
        "name": "Billing Event Log",
        "paymentDate": "2020-01-08T07:38:46-08:00",
        "status": "Allocated",
        "statusDate": "2020-01-08T07:38:46-08:00",
        "account": {
            "id": "0.0.0.1+-account+228862",
            "href": null,
            "description": null,
            "name": "Danielle Rao",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": null,
            "@referredType": "billingAccount"
        },
        "amount": null,
        "channel": {
            "id": "0",
            "href": null,
            "name": "Unspecified",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": null,
            "@referredType": null
        },
        "payer": null,
        "paymentItem": null,
        "paymentMethod": {
            "id": null,
            "href": null,
            "description": null,
            "isPreferred": null,
            "name": "Credit Card",
            "status": null,
            "statusDate": null,
            "account": null,
            "relatedParty": null,
            "validFor": null,
            "@baseType": "PaymentMethodRefOrValue",
            "@schemaLocation": null,
            "@type": "PaymentMethodRefOrValue",
            "@referredType": null
        },
        "taxAmount": null,
        "totalAmount": {
            "unit": "USD",
            "value": 50.0
        },
        "@baseType": "Payment",
        "@schemaLocation": null,
        "@type": "Payment"
    },
    {
        "id": "0.0.0.1+-item-payment+221042",
        "href": "http://host:port/brm/payment/version/payment/0.0.0.1+-item-payment+221042",
        "authorizationCode": null,
        "correlatorId": "P1-7",
        "description": "",
        "name": "Billing Event Log",
        "paymentDate": "2020-01-08T07:33:05-08:00",
        "status": "Allocated",
        "statusDate": "2020-01-08T07:33:05-08:00",
        "account": {
            "id": "0.0.0.1+-account+228862",
            "href": null,
            "description": null,
            "name": "Danielle Rao",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": null,
            "@referredType": "billingAccount"
        },
        "amount": null,
        "channel": {
            "id": "0",
            "href": null,
            "name": "Unspecified",
            "@baseType": null,
            "@schemaLocation": null,
            "@type": null,
            "@referredType": null
        },
        "payer": null,
        "paymentItem": [
            {
                "id": "0.0.0.1+-bill+226434",
                "amount": null,
                "item": {
                    "id": "B1-31",
                    "href": "http://host:port/brm/customerBillManagement/version/customerBill/0.0.0.1+-bill+226434",
                    "name": null,
                    "@baseType": "CustomerBill",
                    "@schemaLocation": null,
                    "@type": "CustomerBill",
                    "@referredType": null
                },
                "taxAmount": null,
                "totalAmount": {
                    "unit": "USD",
                    "value": 55.0
                },
                "@baseType": "PaymentItem",
                "@schemaLocation": null,
                "@type": "PaymentItem"
            }
        ],
        "paymentMethod": {
            "id": null,
            "href": null,
            "description": null,
            "isPreferred": null,
            "name": "Cash",
            "status": null,
            "statusDate": null,
            "account": null,
            "relatedParty": null,
            "validFor": null,
            "@baseType": "PaymentMethodRefOrValue",
            "@schemaLocation": null,
            "@type": "Cash",
            "@referredType": null
        },
        "taxAmount": null,
        "totalAmount": {
            "unit": "USD",
            "value": 200.0
        },
        "@baseType": "Payment",
        "@schemaLocation": null,
        "@type": "Payment"
    }
]