Charge

@Serializable
data class Charge : Serializable

The Charge object contains details about a charge made to a PaymentIntent

Use of this SDK is subject to the Stripe Terminal Terms: https://stripe.com/terminal/legal

Types

Link copied to clipboard
@Serializable
data class CardPresent : Serializable

Transaction details captured for a card-present payment on this Charge.

Properties

Link copied to clipboard
val amount: Long

The amount of the charge

Link copied to clipboard
val amountRefunded: Long

Amount in cents refunded (can be less than the amount attribute on the charge if a partial refund was issued).

Link copied to clipboard
val application: String?

ID of the Connect application that created the Charge.

Link copied to clipboard
val applicationFee: String?

The application fee (if any) for the Charge.

Link copied to clipboard

The amount of the application fee (if any) for the Charge.

Link copied to clipboard
val authorizationCode: String?

6 digit authorization code for this charge.

Link copied to clipboard
val balanceTransaction: String?

ID of the balance transaction that describes the impact of this Charge on your account balance (not including refunds or disputes).

Link copied to clipboard

The full statement descriptor that is displayed on your customer's credit card's statement, after the static statementDescriptor and dynamic statementDescriptorSuffix portions are combined.

Link copied to clipboard
val captured: Boolean

If the Charge was created without capturing, this Boolean represents whether it is still uncaptured or has since been captured.

Link copied to clipboard
val created: Long

Time at which the Charge was created. Measured in seconds since the Unix epoch.

Link copied to clipboard
val currency: String?

Three-letter ISO currency code, in lowercase. Must be a supported currency.

Link copied to clipboard
val customer: String?

ID of the customer this Charge is for if one exists.

Link copied to clipboard
val description: String?

An arbitrary string attached to the Charge. Often useful for displaying to users.

Link copied to clipboard
val dispute: String?

Details about the dispute if the Charge has been disputed.

Link copied to clipboard
val failureCode: String?

Error code explaining reason for charge failure if available.

Link copied to clipboard
val failureMessage: String?

Message to user further explaining reason for charge failure if available.

Link copied to clipboard
val id: String

Unique identifier for the Charge

Link copied to clipboard
val invoice: String?

ID of the invoice this charge is for if one exists.

Link copied to clipboard
val livemode: Boolean

Has the value true if the Charge exists in live mode or the value false if the Charge exists in test mode.

Link copied to clipboard
val metadata: Map<String, String>?

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the Charge in a structured format.

Link copied to clipboard
val onBehalfOf: String?

The account (if any) the Charge was made on behalf of without triggering an automatic transfer.

Link copied to clipboard
val order: String?

ID of the order this Charge is for if one exists.

Link copied to clipboard
val paid: Boolean

true if the Charge succeeded, or was successfully authorized for later capture.

Link copied to clipboard
@SerialName(value = "paymentIntent")
val paymentIntentId: String?

ID of the PaymentIntent associated with this Charge, if one exists.

Link copied to clipboard

A PaymentMethodDetails object containing more details about the charge

Link copied to clipboard
@SerialName(value = "paymentMethod")
val paymentMethodId: String?

ID of the PaymentMethod associated with this Charge, if one exists.

Link copied to clipboard
val receiptEmail: String?

This is the email address that the receipt for this Charge was sent to.

Link copied to clipboard
val receiptNumber: String?

This is the transaction number that appears on email receipts sent for this Charge. This attribute will be null until a receipt has been sent.

Link copied to clipboard
val receiptUrl: String?

This is the URL to view the receipt for this Charge. The receipt is kept up-to-date to the latest state of the Charge, including any refunds. If the Charge is for an Invoice, the receipt will be stylized as an Invoice receipt.

Link copied to clipboard
val refunded: Boolean

Whether the Charge has been fully refunded. If the Charge is only partially refunded, this attribute will still be false.

Link copied to clipboard
val review: String?

ID of the review associated with this Charge if one exists.

Link copied to clipboard
val statementDescriptor: String?

Extra information about a Charge. This will appear on your customer's credit card statement. It must contain at least one letter.

Link copied to clipboard

Extra dynamic information about a Charge. This will appear concatenated with the statementDescriptor on your customer's credit card’s statement.

Link copied to clipboard
val status: String?

The status of the payment is either succeeded, pending, or failed.

Link copied to clipboard
val transfer: String?

ID of the transfer to the destination account (only applicable if the Charge was created using the destination parameter).

Link copied to clipboard
val transferGroup: String?

A string that identifies this transaction as part of a group.