Create Patient Credit Payment

curl --request POST \
  --url https://api.decodahealth.com/billing/payment/patient-credit/create \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "id": "<string>",
  "total": 123,
  "totalOutstanding": 123,
  "status": "OUTSTANDING",
  "patient": {
    "id": "<string>",
    "type": "PROVIDER",
    "createdDate": "2023-11-07T05:31:56Z",
    "firstName": "<string>",
    "lastName": "<string>",
    "phoneNumber": "<string>",
    "email": "<string>",
    "locationId": "<string>",
    "externalId": "<string>",
    "address": "<string>",
    "addressLineTwo": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zipCode": "<string>",
    "country": "<string>",
    "addressValid": true,
    "meta": {},
    "isArchived": true,
    "primaryLocationId": "<string>",
    "gender": "<string>",
    "dateOfBirth": "2023-12-25",
    "patientMedications": [
      "<string>"
    ],
    "onSchedulingBlacklist": true,
    "surchargeDisabled": true,
    "tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "isActive": true,
        "createdDate": "2023-11-07T05:31:56Z",
        "emoji": "<string>",
        "color": "<string>",
        "updatedDate": "2023-11-07T05:31:56Z"
      }
    ],
    "creditBalance": 123,
    "preferredProviderId": "<string>"
  },
  "createdDate": "2023-11-07T05:31:56Z",
  "adjustments": [
    {
      "chargeId": "<string>",
      "id": "<string>",
      "amount": 123,
      "createdDate": "2023-11-07T05:31:56Z",
      "adjustmentType": "WRITE_OFF",
      "providerId": "<string>",
      "locationId": "<string>",
      "reason": "<string>"
    }
  ],
  "payments": [
    {
      "id": "<string>",
      "amount": 123,
      "status": "CANCELED",
      "createdDate": "2023-11-07T05:31:56Z",
      "paymentMedium": "<string>",
      "refunds": [
        {
          "id": "<string>",
          "amount": 123,
          "reason": "DUPLICATE",
          "createdDate": "2023-11-07T05:31:56Z",
          "description": "<string>",
          "creator": {
            "id": "<string>",
            "type": "PROVIDER",
            "firstName": "<string>",
            "lastName": "<string>",
            "phoneNumber": "<string>",
            "email": "<string>",
            "locationId": "<string>"
          }
        }
      ],
      "paymentMethod": {
        "id": "<string>",
        "patientId": "<string>",
        "rainforestPaymentMethodId": "<string>",
        "brand": "<string>",
        "last4": "<string>",
        "expMonth": 123,
        "expYear": 123,
        "accountHolderType": "<string>",
        "accountNumberLast4": 123,
        "bankName": "<string>",
        "routingNumber": 123,
        "description": "<string>",
        "type": "CARD",
        "isDefault": false,
        "isArchived": false
      }
    }
  ],
  "plannedPayments": [
    {
      "id": "<string>",
      "amount": 123,
      "status": "SCHEDULED",
      "paymentDate": "2023-11-07T05:31:56Z"
    }
  ],
  "items": [
    {
      "chargeId": "<string>",
      "quantity": 123,
      "price": 123,
      "id": "<string>",
      "itemId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "discountAmount": 123,
      "discountPercentage": 123,
      "discountReason": "<string>",
      "soldPackageId": "<string>",
      "bankedQuantity": 123,
      "bankedItemId": "<string>",
      "issuedDiscountId": "<string>",
      "soldByProviderId": "<string>",
      "taxAmount": 123,
      "pricingId": "<string>",
      "shipmentIds": [
        "<string>"
      ]
    }
  ],
  "description": "<string>",
  "ruleSetId": "<string>",
  "externalCreatedDate": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "creator": {
    "id": "<string>",
    "type": "PROVIDER",
    "firstName": "<string>",
    "lastName": "<string>",
    "phoneNumber": "<string>",
    "email": "<string>",
    "locationId": "<string>"
  },
  "comment": "<string>",
  "locationId": "<string>",
  "tips": []
}
'

{
  "id": "<string>",
  "amount": 123,
  "status": "CANCELED",
  "paymentMedium": "<string>",
  "createdDate": "2023-11-07T05:31:56Z",
  "feeToPatient": 123,
  "patientId": "<string>",
  "payinId": "<string>",
  "currency": "USD",
  "payinConfigId": "<string>",
  "paymentMethodId": "<string>",
  "stripePaymentIntentId": "<string>",
  "failedReason": "<string>",
  "updatedDate": "2023-11-07T05:31:56Z",
  "fee": 0
}

POST

billing

payment

patient-credit

create

Create Patient Credit Payment

curl --request POST \
  --url https://api.decodahealth.com/billing/payment/patient-credit/create \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "id": "<string>",
  "total": 123,
  "totalOutstanding": 123,
  "status": "OUTSTANDING",
  "patient": {
    "id": "<string>",
    "type": "PROVIDER",
    "createdDate": "2023-11-07T05:31:56Z",
    "firstName": "<string>",
    "lastName": "<string>",
    "phoneNumber": "<string>",
    "email": "<string>",
    "locationId": "<string>",
    "externalId": "<string>",
    "address": "<string>",
    "addressLineTwo": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zipCode": "<string>",
    "country": "<string>",
    "addressValid": true,
    "meta": {},
    "isArchived": true,
    "primaryLocationId": "<string>",
    "gender": "<string>",
    "dateOfBirth": "2023-12-25",
    "patientMedications": [
      "<string>"
    ],
    "onSchedulingBlacklist": true,
    "surchargeDisabled": true,
    "tags": [
      {
        "id": "<string>",
        "name": "<string>",
        "isActive": true,
        "createdDate": "2023-11-07T05:31:56Z",
        "emoji": "<string>",
        "color": "<string>",
        "updatedDate": "2023-11-07T05:31:56Z"
      }
    ],
    "creditBalance": 123,
    "preferredProviderId": "<string>"
  },
  "createdDate": "2023-11-07T05:31:56Z",
  "adjustments": [
    {
      "chargeId": "<string>",
      "id": "<string>",
      "amount": 123,
      "createdDate": "2023-11-07T05:31:56Z",
      "adjustmentType": "WRITE_OFF",
      "providerId": "<string>",
      "locationId": "<string>",
      "reason": "<string>"
    }
  ],
  "payments": [
    {
      "id": "<string>",
      "amount": 123,
      "status": "CANCELED",
      "createdDate": "2023-11-07T05:31:56Z",
      "paymentMedium": "<string>",
      "refunds": [
        {
          "id": "<string>",
          "amount": 123,
          "reason": "DUPLICATE",
          "createdDate": "2023-11-07T05:31:56Z",
          "description": "<string>",
          "creator": {
            "id": "<string>",
            "type": "PROVIDER",
            "firstName": "<string>",
            "lastName": "<string>",
            "phoneNumber": "<string>",
            "email": "<string>",
            "locationId": "<string>"
          }
        }
      ],
      "paymentMethod": {
        "id": "<string>",
        "patientId": "<string>",
        "rainforestPaymentMethodId": "<string>",
        "brand": "<string>",
        "last4": "<string>",
        "expMonth": 123,
        "expYear": 123,
        "accountHolderType": "<string>",
        "accountNumberLast4": 123,
        "bankName": "<string>",
        "routingNumber": 123,
        "description": "<string>",
        "type": "CARD",
        "isDefault": false,
        "isArchived": false
      }
    }
  ],
  "plannedPayments": [
    {
      "id": "<string>",
      "amount": 123,
      "status": "SCHEDULED",
      "paymentDate": "2023-11-07T05:31:56Z"
    }
  ],
  "items": [
    {
      "chargeId": "<string>",
      "quantity": 123,
      "price": 123,
      "id": "<string>",
      "itemId": "<string>",
      "name": "<string>",
      "description": "<string>",
      "discountAmount": 123,
      "discountPercentage": 123,
      "discountReason": "<string>",
      "soldPackageId": "<string>",
      "bankedQuantity": 123,
      "bankedItemId": "<string>",
      "issuedDiscountId": "<string>",
      "soldByProviderId": "<string>",
      "taxAmount": 123,
      "pricingId": "<string>",
      "shipmentIds": [
        "<string>"
      ]
    }
  ],
  "description": "<string>",
  "ruleSetId": "<string>",
  "externalCreatedDate": "2023-11-07T05:31:56Z",
  "externalId": "<string>",
  "creator": {
    "id": "<string>",
    "type": "PROVIDER",
    "firstName": "<string>",
    "lastName": "<string>",
    "phoneNumber": "<string>",
    "email": "<string>",
    "locationId": "<string>"
  },
  "comment": "<string>",
  "locationId": "<string>",
  "tips": []
}
'

{
  "id": "<string>",
  "amount": 123,
  "status": "CANCELED",
  "paymentMedium": "<string>",
  "createdDate": "2023-11-07T05:31:56Z",
  "feeToPatient": 123,
  "patientId": "<string>",
  "payinId": "<string>",
  "currency": "USD",
  "payinConfigId": "<string>",
  "paymentMethodId": "<string>",
  "stripePaymentIntentId": "<string>",
  "failedReason": "<string>",
  "updatedDate": "2023-11-07T05:31:56Z",
  "fee": 0
}

Headers

TENANT

string

required

The tenant you are making this request on behalf of

API-KEY

string

required

Your api key

Body

application/json

string

required

total

integer

required

totalOutstanding

integer

required

status

enum<string>

required

Available options:

OUTSTANDING,

PAID,

EXTERNAL_SETTLEMENT,

VOID,

WRITE_OFF,

REFUNDED,

CHARGEBACK,

PAYMENT_PLAN,

COLLECTIONS

patient

PatientSummary · object

required

Show child attributes

patient.id

string

required

The unique identifier for the user.

patient.type

enum<string>

required

The type of user.

Available options:

PROVIDER,

PATIENT,

ASSISTANT

patient.createdDate

string<date-time>

required

The date and time when the user was created.

patient.firstName

string | null

The user's first name.

patient.lastName

string | null

The user's last name.

patient.phoneNumber

string | null

The user's phone number.

patient.email

string | null

The user's email address.

patient.locationId

string | null

The location of the user.

patient.externalId

string | null

The user's external identifier if available.

patient.address

string | null

The user's primary address.

patient.addressLineTwo

string | null

Additional address information.

patient.city

string | null

The city of the user's address.

patient.state

string | null

The state of the user's address.

patient.zipCode

string | null

The postal code of the user's address.

patient.country

string | null

The country of the user's address.

patient.addressValid

boolean | null

Whether the user's address is valid.

patient.meta

Meta · object

Any additional metadata about the user relevant to your system.

patient.isArchived

boolean | null

Whether the user is archived.

patient.primaryLocationId

string | null

The primary location of the user.

patient.gender

string | null

The gender of the patient.

patient.dateOfBirth

string<date> | null

The date of birth of the patient.

patient.patientMedications

string[] | null

List of patient's self-reported medications.

patient.onSchedulingBlacklist

boolean | null

Whether the patient is on the scheduling blacklist.

patient.surchargeDisabled

boolean | null

Whether surcharges are disabled for this patient.

patient.tags

PatientTagSummary · object[] | null

List of patient tags

Show child attributes

patient.tags.id

string

required

Unique identifier for the patient tag

patient.tags.name

string

required

Name of the patient tag

patient.tags.isActive

boolean

required

Whether the tag is active

patient.tags.createdDate

string<date-time>

required

Date and time when the tag was created

patient.tags.emoji

string | null

Emoji associated with the tag

patient.tags.color

string | null

Color code for the tag (hex format)

patient.tags.updatedDate

string<date-time> | null

Date and time when the tag was last updated

patient.creditBalance

integer | null

Patient's credit balance in cents.

patient.preferredProviderId

string | null

The preferred provider ID for this patient.

createdDate

string<date-time>

required

adjustments

AdjustmentSummary · object[]

required

Show child attributes

adjustments.chargeId

string

required

adjustments.id

string

required

Unique identifier for the adjustment

adjustments.amount

integer

required

Amount of the adjustment

adjustments.createdDate

string<date-time>

required

Date when the adjustment was created

adjustments.adjustmentType

enum<string>

required

Type of the adjustment

Available options:

WRITE_OFF,

ADJUSTMENT,

EXTERNAL_SETTLEMENT

adjustments.providerId

string | null

adjustments.locationId

string | null

adjustments.reason

string | null

Reason for the adjustment

payments

ChargeTablePayment · object[]

required

Show child attributes

payments.id

string

required

payments.amount

integer

required

payments.status

enum<string>

required

Available options:

CANCELED,

CREATED,

FAILED,

IN_REVIEW,

PRESENTING,

PROCESSING,

SUCCEEDED

payments.createdDate

string<date-time>

required

payments.paymentMedium

string

required

payments.refunds

TableRefund · object[]

required

Show child attributes

payments.refunds.id

string

required

payments.refunds.amount

integer

required

payments.refunds.reason

enum<string>

required

Available options:

DUPLICATE,

DISPUTE,

BOOKING_FEE,

OTHER

payments.refunds.createdDate

string<date-time>

required

payments.refunds.description

string | null

payments.refunds.creator

UserTiny · object

Show child attributes

payments.refunds.creator.id

string

required

The unique identifier for the user.

payments.refunds.creator.type

enum<string>

required

The type of user.

Available options:

PROVIDER,

PATIENT,

ASSISTANT

payments.refunds.creator.firstName

string | null

The user's first name.

payments.refunds.creator.lastName

string | null

The user's last name.

payments.refunds.creator.phoneNumber

string | null

The user's phone number.

payments.refunds.creator.email

string | null

The user's email address.

payments.refunds.creator.locationId

string | null

The location of the user.

payments.paymentMethod

PaymentMethodSummary · object

Show child attributes

payments.paymentMethod.id

string

required

payments.paymentMethod.patientId

string | null

required

payments.paymentMethod.rainforestPaymentMethodId

string

required

payments.paymentMethod.brand

string | null

required

payments.paymentMethod.last4

string | null

required

payments.paymentMethod.expMonth

integer | null

required

payments.paymentMethod.expYear

integer | null

required

payments.paymentMethod.accountHolderType

string | null

required

payments.paymentMethod.accountNumberLast4

integer | null

required

payments.paymentMethod.bankName

string | null

required

payments.paymentMethod.routingNumber

integer | null

required

payments.paymentMethod.description

string | null

required

payments.paymentMethod.type

enum<string> | null

required

Available options:

CARD,

ACH,

APPLE_PAY

payments.paymentMethod.isDefault

boolean

default:false

payments.paymentMethod.isArchived

boolean

default:false

plannedPayments

ChargeTablePlannedPayment · object[]

required

Show child attributes

plannedPayments.id

string

required

plannedPayments.amount

integer

required

plannedPayments.status

enum<string>

required

Available options:

SCHEDULED,

COMPLETED,

FAILED,

CANCELLED

plannedPayments.paymentDate

string<date-time>

required

items

ChargeItem · object[]

required

Show child attributes

items.chargeId

string

required

Identifier of the charge this item is associated with

items.quantity

integer

required

Quantity of the item being charged

items.price

integer

required

Price of the item in cents

items.id

string | null

Unique identifier for the charge item

items.itemId

string | null

Optional unique identifier for the item

items.name

string | null

Name of the item (None for items with associated inventory item)

items.description

string | null

Description of the item

items.discountAmount

integer | null

Discount amount for the item

items.discountPercentage

number | null

Discount percentage for the item

items.discountReason

string | null

Reason for discount

items.soldPackageId

string | null

Unique identifier for the sold package usage

items.bankedQuantity

integer | null

Quantity to bank for later use

items.bankedItemId

string | null

ID of banked item being used (for tracking usage)

items.issuedDiscountId

string | null

Unique identifier for the specific issued discount instance used

items.soldByProviderId

string | null

Unique identifier for the provider who sold the item

items.taxAmount

integer | null

Tax amount for the item in cents

items.pricingId

string | null

Unique identifier for the pricing for the item

items.shipmentIds

string[] | null

Optional list of shipment IDs to reduce the stock quantity of

description

string | null

ruleSetId

string | null

externalCreatedDate

string<date-time> | null

externalId

string | null

creator

UserTiny · object

Show child attributes

creator.id

string

required

The unique identifier for the user.

creator.type

enum<string>

required

The type of user.

Available options:

PROVIDER,

PATIENT,

ASSISTANT

creator.firstName

string | null

The user's first name.

creator.lastName

string | null

The user's last name.

creator.phoneNumber

string | null

The user's phone number.

creator.email

string | null

The user's email address.

creator.locationId

string | null

The location of the user.

comment

string | null

locationId

string | null

tips

TipDetail · object[]

List of Tips in the Charge.

Show child attributes

tips.chargeId

string

required

Charge ID this tip belongs to

tips.amount

integer

required

Tip amount in cents

tips.providerId

string

required

Provider ID receiving the tip

tips.id

string

Unique identifier for the tip

tips.provider

ProviderTiny · object

Provider receiving the tip

Show child attributes

tips.provider.id

string

required

tips.provider.firstName

string

required

tips.provider.lastName

string | null

tips.provider.email

string | null

tips.provider.createdDate

string<date-time> | null

Response

Successful Response

string

required

The unique identifier for the payment.

amount

integer

required

The total amount of the payment.

status

enum<string>

required

The current status of the payment.

Available options:

CANCELED,

CREATED,

FAILED,

IN_REVIEW,

PRESENTING,

PROCESSING,

SUCCEEDED

paymentMedium

string

required

The name of the payment medium.

createdDate

string<date-time>

required

The date and time the payment was created.

feeToPatient

integer

required

The fee charged to the patient for the transaction.

patientId

string | null

The ID of the patient associated with the payment.

payinId

string | null

The ID of the payin associated with the payment.

currency

string

default:USD

The currency in which the payment was made.

payinConfigId

string | null

The configuration ID for the payin.

paymentMethodId

string | null

The ID of the payment method used.

stripePaymentIntentId

string | null

Stripe's payment intent ID if used.

failedReason

string | null

Reason for payment failure if applicable.

updatedDate

string<date-time> | null

The date and time the payment was last updated.

fee

integer

default:0

The fee charged by the payment processor.

Create Manual Invoice Create Patient Credit Settled

⌘I

Getting Started

API

Tenant

Webhook

Create Patient Credit Payment

Headers

Body

Response