CData Python Connector for Stripe

Build 23.0.8839

Charges

Create, update, and query the available Charges in Stripe.

Table Specific Information

In this table only select, insert, and update operations are allowed.

Select

Server-Side Query Support

The connector uses the Stripe API to filter the results by the following columns and operators while the rest of the filter is executed client-side within the connector.

  • Id supports the = operator.
  • Amount supports the <,>>=,<=,=,!= operators.
  • Currency supports the =,!= operator.
  • CustomerId supports the =,!= operator.
  • BillingDetailsAddressPostalCode supports the =,!= operator.
  • Created supports the <,>>=,<=,=,!= operators.
  • Disputed supports the =,!= operator.
  • MetadataAggregate supports the = operator.
  • PaymentIntent supports the = operator.
  • Refunded supports the =,!= operator.
  • Status supports the =,!= operator.
  • TransferGroup supports the = operator.
  • AccountId supports the = operator.

The provider supports the use of all columns as criteria in the WHERE clause of SELECT statements, as long as SupportEnhancedSQL is set to True. If SupportEnhancedSQL property is set to False, you still can retrieve:

-a Charge by specifying its Id:

SELECT * FROM Charges WHERE Id = 'ch_12345678'

-Charges that belong to a Customer:

SELECT * FROM Charges WHERE CustomerId = 'cus_12345678'

-Charges created after a specific date (Created may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range):

SELECT * FROM Charges WHERE Created > '2016-01-03'

Insert

Amount, Currency and Customer or Source columns are required to charge a credit card.

INSERT INTO Charges (Amount, Currency, CustomerId) VALUES (2000, 'usd', 'cus_12345678')

Update

To modify a Charge, provide an Id.

UPDATE Charges SET Description = 'updated charge' WHERE Id = 'ch_17rPMOATXQzBWNrliIRnfI5B'

Delete

Delete is not supported.

Columns

Name Type ReadOnly References Description
Id [KEY] String True

The Id of the charge.

Amount Integer False

The amount of the charge.

Currency String False

The currency of the charge.

CustomerId String False

The customer Id of the charge.

AmountRefunded Integer True

The amount in cents refunded.

ApplicationFee String True

The application fee (if any) for the charge.

ApplicationFeeAmount Integer False

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

BalanceTransaction String True

The Id of the balance transaction that describes the impact of this charge on your account balance .

BillingDetailsAddressCity String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsAddressCountry String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsAddressLine1 String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsAddressLine2 String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsAddressPostalCode String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsAddressState String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsEmail String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsName String True

Billing information associated with the payment method at the time of the transaction.

BillingDetailsPhone String True

Billing information associated with the payment method at the time of the transaction.

Captured Boolean False

Whether the charge was created without capturing.

CalculatedStatementDescriptor String True

The full statement descriptor that is passed to card networks, and that is displayed on your customers' credit card and bank statements. Allows you to see what the statement descriptor looks like after the static and dynamic portions are combined.

Created Datetime True

The datetime the charge was created.

Description String False

The description of the charge.

Destination String True

The account (if any) the charge was made on behalf of.

Disputed Boolean True

Whether the charge has been disputed.

DisputeId String True

The Id of the associated dispute.

FailureCode String True

The error code explaining the reason for the charge failure if available.

FailureMessage String True

The message to the user further explaining the reason for the charge failure if available.

FraudDetailsStripeReport String True

Information on fraud assessments for the charge.

FraudDetailsUserReport String False

Information on fraud assessments for the charge.

Invoice String True

The Id of the invoice this charge is for if one exists.

Livemode Boolean True

Whether the charge is in live mode.

MetadataAggregate String False

The charge metadata object.

Order String True

The Id of the order this charge is for if one exists.

OutcomeAggregate String True

Details about whether the payment was accepted, and why. See understanding declines for details.

Paid Boolean True

If the charge succeeded or was successfully authorized for later capture.

PaymentIntent String True

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

PaymentMethod String True

ID of the payment method used in this charge.

PaymentMethodDetailsAggregate String True

Details about the payment method at the time of the transaction.

ReceiptEmail String False

The email address that the receipt for this charge was sent to.

ReceiptNumber String True

The transaction number that appears on email receipts sent for this charge.

ReceiptURL String True

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 is stylized as an Invoice receipt.

Refunded Boolean True

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

RefundsAggregate String True

The list of refunds that have been applied to the charge.

Review String True

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

ShippingAddressCity String False

Shipping information for the charge. Shipping address. City, district, suburb, town, or village.

ShippingAddressCountry String False

Shipping information for the charge. Shipping address. Two-letter country code (ISO 3166-1 alpha-2)

ShippingAddressLine1 String False

Shipping information for the charge. Shipping address. Address line 1 (e.g., street, PO Box, or company name).

ShippingAddressLine2 String False

Shipping information for the charge. Shipping address. Address line 2 (e.g., apartment, suite, unit, or building).

ShippingAddressPostalCode String False

Shipping information for the charge. Shipping address. ZIP or postal code.

ShippingAddressState String False

Shipping information for the charge. Shipping address. State, county, province, or region.

ShippingCarrier String False

Shipping information for the charge. The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.

ShippingName String False

Shipping information for the charge. Recipient name.

ShippingPhone String False

Shipping information for the charge. Recipient phone (including extension).

ShippingTrackingNumber String False

Shipping information for the charge. The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.

SourceAggregate String False

The source of every charge is a credit or debit card.

SourceTransfer String True

The transfer Id that created this charge.

StatementDescriptor String False

The extra information about a charge.

Status String True

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

Transfer String True

The Id of the transfer to the destination account.

TransferDataAmount Integer False

An optional dictionary including the account to automatically transfer to as part of a destination charge.

TransferDataDestination String False

An optional dictionary including the account to automatically transfer to as part of a destination charge.

TransferGroup String False

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

StatementDescriptorSuffix String False

Provides information about the charge that customers see on their statements.

Object String True

String representing the object's type. Objects of the same type share the same value.

AmountCaptured Integer True

Amount in cents captured

Application String True

ID of the Connect application that created the charge.

FailureBalanceTransaction String True

ID of the balance transaction that describes the reversal of the balance on your account due to payment failure.

OnBehalfOf String False

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

RadarOptionsSession String False

Options to configure Radar. A Radar Session is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.

Pseudo-Columns

Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.

Name Type Description
AccountId String

The Id of the connected account to get charges for

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 23.0.8839