POST
/
v1
/
charge
/
create

Headers

TENANT
string
required

The tenant you are making this request on behalf of

API-KEY
string
required

Your api key

Body

application/json

Create a Charge for a Patient. These typically come from balances owed to the Tenant by the Patient (i.e. due to a copay).

patientId
string
required

Identifier of the patient being charged.

totalOutstanding
integer
required

Total outstanding amount that is yet to be paid.

creatorId
string | null

Identifier of the Provider who created the charge (i.e. the Doctor, or relevant Biller).

customAmount
integer
default:
0

If you want to bill for an un-itemized amount, set it here.

description
string | null

Description of the charge.

discountAmount
integer | null
default:
0

Any discount applied to the total outstanding.

discountPercentage
number | null
default:
0

Percentage of discount applied to the charge.

externalCreatedDate
string | null

The creation date of the charge in your external system, if applicable.

externalId
string | null

External identifier for the charge, if applicable.

items
object[]

List of Items in the Charge.

meta
object | null

Any additional metadata about the charge relevant to your system.

patientPaysProcessingFee
boolean | null
default:
false

Indicates if the patient is responsible for processing fees.

ruleSetId
string | null

Identifier for the RuleSet applied to this Charge, if any.

status
enum<string>

Current status of the charge.

Available options:
OUTSTANDING,
PAID,
EXTERNAL_SETTLEMENT,
VOID,
WRITE_OFF,
REFUNDED,
PAYMENT_PLAN
subscriptionId
string | null

Identifier of the Subscription this charge is associated with, if any.

Response

200 - application/json
adjustments
object[]
required
createdDate
string
required

The date when the charge was created.

customAmount
integer
required

Any un-itemized amount that makes up the charge.

discountAmount
integer
required

Amount of discount applied to the charge.

discountPercentage
number
required

Percentage of discount applied to the charge.

explanationOfBenefits
object[]
required
id
string
required

Unique identifier for the charge.

items
object[]
required
patient
object
required

Summary details of the patient being charged.

patientId
string
required

Identifier of the patient being charged.

patientPaysProcessingFee
boolean
required

Indicates if the patient is responsible for processing fees.

payments
object[]
required
status
enum<string>
required

Current status of the charge.

Available options:
OUTSTANDING,
PAID,
EXTERNAL_SETTLEMENT,
VOID,
WRITE_OFF,
REFUNDED,
PAYMENT_PLAN
total
integer
required

Total amount of the charge.

totalOutstanding
integer
required

Total outstanding amount that is yet to be paid or adjusted away.

description
string | null

Description of the charge.

externalCreatedDate
string | null

The creation date of the charge in your external system, if applicable.

externalId
string | null

External identifier for the charge, if applicable.

meta
object | null

Any additional metadata about the charge relevant to your system.

ruleSetId
string | null

Identifier for the rule set applied to this charge, if any.