type Payment

FieldTypeDescription
idID!

Unique id of the payment (a bare KSUID).

orgIdID

The platform organization that facilitated this payment.

providerPaymentProvider

Payment provider that was used to process this payment

instrumentPaymentInstrument

What moved the money — a card, an ACH or Plaid debit or credit, or FlexPay financing. Null means not reported: payments taken before this was recorded carry none, and so does one whose provider notification did not name a method. Null is never a claim that no instrument was used.

configurationIdID

ID of the payment provider configuration that facilitated this payment

originalAmountAmount!

Original amount for the payment. If this payment has only been authorized and is in a pending state this will be the amount authorized for the payment.

amountAmount!

Amount of the payment. This may differ from the orginal amount if the captured payment amount is different than the authorized amount.

netAmountAmount

Amount of the payment less the processing fees taken on it. Null means not reported — the fees are not known until the provider reports them, which for a captured payment is at settlement. Null is never a confirmed zero.

feeAmountAmount

Fees taken on the payment, summed across every fee the provider books against it. Null means not reported — the fees are not known until the provider reports them. Null is never a confirmed zero. Where both are reported, netAmount + feeAmount is the amount charged; refunds are not netted into either.

refundAmountAmount

Total refunded against this payment so far. Null means not reported — not a confirmed zero, so do not read it as "never refunded". A refund the provider has accepted but not yet settled is already counted once reporting begins, so this can exceed what has actually moved back.

currencyCurrency!

Currency of the payment

statusPaymentStatus!

Status of the payment

dateDateTime!

The date the payment was created. If payments are pre-created pending, this date will be updated when the payment is actually completed.

expectedSettlementDateString

The estimates date funds will be settled.

expectedFundsAvailableDateString

The estimated date funds will be available to the merchant.

sourcePaymentSource

Integration source details for this payment.

contactIdID

Optional ID of the platform contact associated with this payment.

paymentSessionIdID

ID of the payment session that facilitated this payment

paymentPlanIdID

ID of the payment plan that generated this payment

paymentMethodIdID

ID of the stored payment method that was charged to create this payment. Null when the payment did not come from a stored method.

paymentMethodPaymentMethod

Stored payment method that was charged to create this payment. Null when the payment did not come from a stored method.

recurringProcessingModelRecurringProcessingModel

How this payment was declared to the card networks. Set on a payment made from a stored method and on the payment that stored one; null otherwise. Kept on the record so a disputed charge, or an audit of how a series was declared, can be answered from the payment itself.

paymentSessionPaymentSession

Payment session that facilitated this payment