Class/Object

org.mdedetrich.stripe.v1.Charges

ChargeInput

Related Docs: object ChargeInput | package Charges

Permalink

case class ChargeInput(amount: BigDecimal, currency: Currency, applicationFee: Option[BigDecimal], capture: Boolean, description: Option[String], destination: Option[String], metadata: Map[String, String], receiptEmail: Option[String], shipping: Option[Shipping], customer: Option[Customer], source: Option[Card], statementDescriptor: Option[String]) extends StripeObject with Product with Serializable

amount

A positive integer in the smallest currency unit (e.g 100 cents to charge $1.00, or 1 to charge ¥1, a 0-decimal currency) representing how much to charge the card. The minimum amount is $0.50 (or equivalent in charge currency).

currency

3-letter ISO code for currency.

applicationFee

A fee in cents that will be applied to the charge and transferred to the application owner's Stripe account. To use an application fee, the request must be made on behalf of another account, using the Stripe-Account header, an OAuth key, or the Charge.destination parameter. For more information, see the application fees documentation.

capture

Whether or not to immediately capture the charge. When false, the charge issues an authorization (or pre-authorization), and will need to be captured later. Uncaptured charges expire in 7 days. For more information, see authorizing charges and settling later.

description

An arbitrary string which you can attach to a charge object. It is displayed when in the web interface alongside the charge. Note that if you use Stripe to send automatic email receipts to your customers, your receipt emails will include the description of the charge(s) that they are describing.

destination

An account to make the charge on behalf of. If specified, the charge will be attributed to the destination account for tax reporting, and the funds from the charge will be transferred to the destination account. The ID of the resulting transfer will be returned in the transfer field of the response. See the documentation for details.

metadata

A set of key/value pairs that you can attach to a charge object. It can be useful for storing additional information about the customer in a structured format. It's often a good idea to store an email address in metadata for tracking later.

receiptEmail

The email address to send this charge's receipt to. The receipt will not be sent until the charge is paid. If this charge is for a customer, the email address specified here will override the customer's email address. Receipts will not be sent for test mode charges. If receiptEmail is specified for a charge in live mode, a receipt will be sent regardless of your email settings.

shipping

Shipping information for the charge. Helps prevent fraud on charges for physical goods. For more information, see the Charge object documentation.

customer

The ID of an existing customer that will be charged in this request.

source

A payment source to be charged, such as a credit card. If you also pass a customer ID, the source must be the ID of a source belonging to the customer. Otherwise, if you do not pass a customer ID, the source you provide must either be a token, like the ones returned by Stripe.js, or a dictionary containing a user's credit card details, with the options described below. Although not all information is required, the extra info helps prevent fraud.

statementDescriptor

An arbitrary string to be displayed on your customer's credit card statement. This may be up to 22 characters. As an example, if your website is RunClub and the item you're charging for is a race ticket, you may want to specify a statementDescriptor of RunClub 5K race ticket. The statement description may not include <>"' characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. While most banks display this information consistently, some may display it incorrectly or not at all.

Exceptions thrown

StatementDescriptorInvalidCharacter - If statementDescriptor has an invalid character

StatementDescriptorTooLong - If statementDescriptor is longer than 22 characters

See also

https://stripe.com/docs/api#create_charge

Linear Supertypes
Serializable, Serializable, Product, Equals, StripeObject, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. ChargeInput
  2. Serializable
  3. Serializable
  4. Product
  5. Equals
  6. StripeObject
  7. AnyRef
  8. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new ChargeInput(amount: BigDecimal, currency: Currency, applicationFee: Option[BigDecimal], capture: Boolean, description: Option[String], destination: Option[String], metadata: Map[String, String], receiptEmail: Option[String], shipping: Option[Shipping], customer: Option[Customer], source: Option[Card], statementDescriptor: Option[String])

    Permalink

    amount

    A positive integer in the smallest currency unit (e.g 100 cents to charge $1.00, or 1 to charge ¥1, a 0-decimal currency) representing how much to charge the card. The minimum amount is $0.50 (or equivalent in charge currency).

    currency

    3-letter ISO code for currency.

    applicationFee

    A fee in cents that will be applied to the charge and transferred to the application owner's Stripe account. To use an application fee, the request must be made on behalf of another account, using the Stripe-Account header, an OAuth key, or the Charge.destination parameter. For more information, see the application fees documentation.

    capture

    Whether or not to immediately capture the charge. When false, the charge issues an authorization (or pre-authorization), and will need to be captured later. Uncaptured charges expire in 7 days. For more information, see authorizing charges and settling later.

    description

    An arbitrary string which you can attach to a charge object. It is displayed when in the web interface alongside the charge. Note that if you use Stripe to send automatic email receipts to your customers, your receipt emails will include the description of the charge(s) that they are describing.

    destination

    An account to make the charge on behalf of. If specified, the charge will be attributed to the destination account for tax reporting, and the funds from the charge will be transferred to the destination account. The ID of the resulting transfer will be returned in the transfer field of the response. See the documentation for details.

    metadata

    A set of key/value pairs that you can attach to a charge object. It can be useful for storing additional information about the customer in a structured format. It's often a good idea to store an email address in metadata for tracking later.

    receiptEmail

    The email address to send this charge's receipt to. The receipt will not be sent until the charge is paid. If this charge is for a customer, the email address specified here will override the customer's email address. Receipts will not be sent for test mode charges. If receiptEmail is specified for a charge in live mode, a receipt will be sent regardless of your email settings.

    shipping

    Shipping information for the charge. Helps prevent fraud on charges for physical goods. For more information, see the Charge object documentation.

    customer

    The ID of an existing customer that will be charged in this request.

    source

    A payment source to be charged, such as a credit card. If you also pass a customer ID, the source must be the ID of a source belonging to the customer. Otherwise, if you do not pass a customer ID, the source you provide must either be a token, like the ones returned by Stripe.js, or a dictionary containing a user's credit card details, with the options described below. Although not all information is required, the extra info helps prevent fraud.

    statementDescriptor

    An arbitrary string to be displayed on your customer's credit card statement. This may be up to 22 characters. As an example, if your website is RunClub and the item you're charging for is a race ticket, you may want to specify a statementDescriptor of RunClub 5K race ticket. The statement description may not include <>"' characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. While most banks display this information consistently, some may display it incorrectly or not at all.

    Exceptions thrown

    StatementDescriptorInvalidCharacter - If statementDescriptor has an invalid character

    StatementDescriptorTooLong - If statementDescriptor is longer than 22 characters

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  4. val amount: BigDecimal

    Permalink

    A positive integer in the smallest currency unit (e.g 100 cents to charge $1.00, or 1 to charge ¥1, a 0-decimal currency) representing how much to charge the card.

    A positive integer in the smallest currency unit (e.g 100 cents to charge $1.00, or 1 to charge ¥1, a 0-decimal currency) representing how much to charge the card. The minimum amount is $0.50 (or equivalent in charge currency).

  5. val applicationFee: Option[BigDecimal]

    Permalink

    A fee in cents that will be applied to the charge and transferred to the application owner's Stripe account.

    A fee in cents that will be applied to the charge and transferred to the application owner's Stripe account. To use an application fee, the request must be made on behalf of another account, using the Stripe-Account header, an OAuth key, or the Charge.destination parameter. For more information, see the application fees documentation.

  6. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  7. val capture: Boolean

    Permalink

    Whether or not to immediately capture the charge.

    Whether or not to immediately capture the charge. When false, the charge issues an authorization (or pre-authorization), and will need to be captured later. Uncaptured charges expire in 7 days. For more information, see authorizing charges and settling later.

  8. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  9. val currency: Currency

    Permalink

    3-letter ISO code for currency.

  10. val customer: Option[Customer]

    Permalink

    The ID of an existing customer that will be charged in this request.

  11. val description: Option[String]

    Permalink

    An arbitrary string which you can attach to a charge object.

    An arbitrary string which you can attach to a charge object. It is displayed when in the web interface alongside the charge. Note that if you use Stripe to send automatic email receipts to your customers, your receipt emails will include the description of the charge(s) that they are describing.

  12. val destination: Option[String]

    Permalink

    An account to make the charge on behalf of.

    An account to make the charge on behalf of. If specified, the charge will be attributed to the destination account for tax reporting, and the funds from the charge will be transferred to the destination account. The ID of the resulting transfer will be returned in the transfer field of the response. See the documentation for details.

  13. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  14. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  15. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  16. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  17. val metadata: Map[String, String]

    Permalink

    A set of key/value pairs that you can attach to a charge object.

    A set of key/value pairs that you can attach to a charge object. It can be useful for storing additional information about the customer in a structured format. It's often a good idea to store an email address in metadata for tracking later.

  18. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  19. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  20. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  21. val receiptEmail: Option[String]

    Permalink

    The email address to send this charge's receipt to.

    The email address to send this charge's receipt to. The receipt will not be sent until the charge is paid. If this charge is for a customer, the email address specified here will override the customer's email address. Receipts will not be sent for test mode charges. If receiptEmail is specified for a charge in live mode, a receipt will be sent regardless of your email settings.

  22. val shipping: Option[Shipping]

    Permalink

    Shipping information for the charge.

    Shipping information for the charge. Helps prevent fraud on charges for physical goods. For more information, see the Charge object documentation.

  23. val source: Option[Card]

    Permalink

    A payment source to be charged, such as a credit card.

    A payment source to be charged, such as a credit card. If you also pass a customer ID, the source must be the ID of a source belonging to the customer. Otherwise, if you do not pass a customer ID, the source you provide must either be a token, like the ones returned by Stripe.js, or a dictionary containing a user's credit card details, with the options described below. Although not all information is required, the extra info helps prevent fraud.

  24. val statementDescriptor: Option[String]

    Permalink

    An arbitrary string to be displayed on your customer's credit card statement.

    An arbitrary string to be displayed on your customer's credit card statement. This may be up to 22 characters. As an example, if your website is RunClub and the item you're charging for is a race ticket, you may want to specify a statementDescriptor of RunClub 5K race ticket. The statement description may not include <>"' characters, and will appear on your customer's statement in capital letters. Non-ASCII characters are automatically stripped. While most banks display this information consistently, some may display it incorrectly or not at all.

  25. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  26. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  27. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  28. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Inherited from Serializable

Inherited from Serializable

Inherited from Product

Inherited from Equals

Inherited from StripeObject

Inherited from AnyRef

Inherited from Any

Ungrouped