java.lang.Object | |
↳ | com.wsl.modules.stripe.StripeConnector |
Known Direct Subclasses |
Known Indirect Subclasses |
Anypoint Connector
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Cancel a Subscription
| |||||||||||
Capture a Charge
| |||||||||||
Create an Account
| |||||||||||
Create an Application Fee Refund
Refunds an application fee that has previously been collected but not yet refunded.
| |||||||||||
Create a Bank Account Token
Creates a single use token that wraps the details of a bank account.
| |||||||||||
Create a BitCoin Receiver
Creates a Bitcoin receiver object that can be used to accept bitcoin payments from your customer.
| |||||||||||
Create a Card
Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe.
| |||||||||||
Create a Card Token
| |||||||||||
Create a Charge
| |||||||||||
Create a Coupon
| |||||||||||
Create a Customer
| |||||||||||
Create a file upload
To upload a file to Stripe, you'll need to send a request of type multipart/form-data.
| |||||||||||
Create an invoice
Invoices are statements of what a customer owes for a particular billing period, including subscriptions, invoice items, and any automatic proration adjustments if necessary.
| |||||||||||
Create a Plan
| |||||||||||
Create a Refund
When you create a new refund, you must specify a charge to create it on.
| |||||||||||
Create a Subscription
| |||||||||||
Delete a Card
| |||||||||||
Delete a Coupon
| |||||||||||
Delete a Customer
| |||||||||||
Delete a Plan
| |||||||||||
List Active Subscriptions
| |||||||||||
List All Application Fee Refunds
You can see a list of the refunds belonging to a specific application fee.
| |||||||||||
List all Application Fees
| |||||||||||
List all Balance History
| |||||||||||
List All Bitcoin Receivers
Returns a list of your receivers.
| |||||||||||
List all Charges
| |||||||||||
List all Coupons
| |||||||||||
List all Customer Cards
Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe.
| |||||||||||
List all Customers
| |||||||||||
List All Events
List events, going back up to 30 days.
| |||||||||||
List All Plans
| |||||||||||
List All Refunds
You can see a list of the refunds belonging to a specific charge.
| |||||||||||
Pay an invoice
| |||||||||||
Retrieve an Account's Details
| |||||||||||
List all Invoices
| |||||||||||
Retrieve an Application Fee
| |||||||||||
Retrieve an Application Fee Refund
By default, you can see the 10 most recent refunds stored directly on the application fee object, but you can also retrieve details about a specific refund stored on the application fee.
| |||||||||||
Retrieve the balance
| |||||||||||
Retrieve a Balance Transaction
| |||||||||||
Retrieve a Bitcoin Receiver
Retrieves the Bitcoin receiver with the given ID.
| |||||||||||
Retrieve a Card
Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe.
| |||||||||||
Retrieve a Charge
| |||||||||||
Retrieve a Coupon
| |||||||||||
Retrieve a Customer
| |||||||||||
Retrieve a Event
Retrieves the Event with the given ID
| |||||||||||
Retrieve an Invoice
| |||||||||||
Retrieve an invoice's line items
When retrieving an invoice, you'll get a lines property containing the total count of line items and the first handful of those items.
| |||||||||||
Retrieve a Plan
| |||||||||||
Retrieve a Refund
By default, you can see the 10 most recent refunds stored directly on the charge object, but you can also retrieve details about a specific refund stored on the charge.
| |||||||||||
Retrieve a Subscription
| |||||||||||
Retrieve a Token
Retrieves the token with the given ID
| |||||||||||
Retrieve an upcoming invoice
At any time, you can preview the upcoming invoice for a customer.
| |||||||||||
Update an Account
You may only update accounts that you manage.
| |||||||||||
Update an Application Fee Refund
Updates the specified application fee refund by setting the values of the parameters passed.
| |||||||||||
Update a Card
Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe.
| |||||||||||
Update a Charge
Updates the specified charge by setting the values of the parameters passed.
| |||||||||||
Update a Coupon
Updates the metadata of a coupon.
| |||||||||||
Update a Customer.
| |||||||||||
Update an invoice
| |||||||||||
Update a Plan
| |||||||||||
Update a Refund
Updates the specified refund by setting the values of the parameters passed.
| |||||||||||
Update a Subscription
Note that Stripe uses a specific policy around prorating changed subscriptions.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Cancel a Subscription
customerId | The ID of the customer to cancel the subscription of |
---|---|
subscriptionId | ID of subscription to cancel. |
StripeConnectorException | when there is a problem with the Connector |
---|
Capture a Charge
id | The id of the charge to capture |
---|---|
amount | The amount to capture, which must be less than or equal to the original amount. Any additional amount will be automatically refunded. |
applicationFee | An application fee to add on to this charge. Can only be used with Stripe Connect. |
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 statement_descriptor 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. |
receiptEmail | The email the receipt should be sent to |
StripeConnectorException | when there is a problem with the Connector |
---|
Create an Account
createAccountParameters | Wrapper for the complex parameter set |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Create an Application Fee Refund Refunds an application fee that has previously been collected but not yet refunded. Funds will be refunded to the Stripe account that the fee was originally collected from. You can optionally refund only part of an application fee. You can do so as many times as you wish until the entire fee has been refunded. Once entirely refunded, an application fee can't be refunded again. This method will throw an error when called on an already-refunded application fee, or when trying to refund more money than is left on an application fee.
id | The identifier of the application fee to be refunded. |
---|---|
amount | A positive integer in cents representing how much of this fee to refund. Can only refund up to the unrefunded amount remaining of the fee. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Bank Account Token Creates a single use token that wraps the details of a bank account. This token can be used in place of a bank account Map with any API method. These tokens can only be used once: by attaching them to a recipient.
bankAccountId | The bank account's ID, or... |
---|---|
bankAccount | ... Otherwise, if you do not pass a bank account ID, a Map containing a the account details |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a BitCoin Receiver Creates a Bitcoin receiver object that can be used to accept bitcoin payments from your customer. The receiver exposes a Bitcoin address and is created with a bitcoin to USD exchange rate that is valid for 10 minutes.
amount | The amount of currency that you will be paid |
---|---|
currency | The currency to which the bitcoin will be converted. You will be paid out in this currency. Only USD is currently supported. |
The email address of the customer. | |
description | A description of the receiver |
metadata | A set of key/value pairs that you can attach to a customer object. It can be useful for storing additional information about the customer in a structured format. |
refundMispayments | A flag that indicates whether you would like Stripe to automatically handle refunds for any mispayments to the receiver. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Card Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe. Stripe Connect is the recommended means for transferring funds.
ownerId | The ID for the Customer or Recipient |
---|---|
sourceToken | The source can either be a token, like the ones returned by Stripe.js, |
source | Or a dictionary containing a user’s credit card details (with the options shown below). Whenever you create a new card for a customer, Stripe will automatically validate the card. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Card Token
cardId | The card this token will represent. If you also pass in a customer, the card must be the ID of a card belonging to the customer... |
---|---|
card | ... Otherwise, if you do not pass a customer, a Map containing a user's credit card details |
customer | For use with Stripe Connect only; this can only be used with an OAuth access token or Stripe-Account header.. For more details, see the shared customers documentation. A customer (owned by the application's account) to create a token for. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Charge
createChargeParameters | Wrapper object for Create Charge Parameters |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Coupon
id | Unique string of your choice that will be used to identify this coupon when applying it a customer. This is often a specific code you’ll give to your customer to use when signing up (e.g. FALL25OFF). If you don’t want to specify a particular code, you can leave the ID blank and we’ll generate a random code for you. |
---|---|
duration | Specifies how long the discount will be in effect. Can be forever, once, or repeating. |
amountOff | A positive integer representing the amount to subtract from an invoice total (required if percent_off is not passed) |
currency | Currency of the amount_off parameter (required if amount_off is passed) |
durationInMonths | Required only if duration is repeating If duration is repeating, a positive integer that specifies the number of months the discount will be in effect |
maxRedemptions | A positive integer specifying the number of times the coupon can be redeemed before it’s no longer valid. For example, you might have a 50% off coupon that the first 20 readers of your blog can use. |
percentOff | A positive integer between 1 and 100 that represents the discount the coupon will apply (required if amount_off is not passed) |
redeemBy | Unix timestamp specifying the last time at which the coupon can be redeemed. After the redeem_by date, the coupon can no longer be applied to new customers. |
metadata | A set of key/value pairs that you can attach to a coupon object. It can be useful for storing additional information about the coupon in a structured format. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Customer
accountBalance | An integer amount in cents that is the starting account balance for your customer. A negative amount represents a credit that will be used before attempting any charges to the customer’s card; a positive amount will be added to the next invoice. |
---|---|
couponCode | If you provide a coupon code, the customer will have a discount applied on all recurring charges. Charges you create through the API will not have the discount. |
description | An arbitrary string that you can attach to a customer object. It is displayed alongside the customer in the dashboard. |
Customer’s email address. | |
metadata | A set of key/value pairs that you can attach to a customer object. It can be useful for storing additional information about the customer in a structured format. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a file upload To upload a file to Stripe, you'll need to send a request of type multipart/form-data. The request should contain the file you would like to upload, as well as the parameters for creating a file.
file | A file to upload. The file should follow the specifications of RFC 2388 (which defines file transfers for the multipart/form-data protocol). |
---|---|
purpose | The purpose of the uploaded file. Possible values are identity_document, dispute_evidence. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create an invoice Invoices are statements of what a customer owes for a particular billing period, including subscriptions, invoice items, and any automatic proration adjustments if necessary. Once an invoice is created, payment is automatically attempted. Note that the payment, while automatic, does not happen exactly at the time of invoice creation. If you have configured webhooks, the invoice will wait until one hour after the last webhook is successfully sent (or the last webhook times out after failing). Any customer credit on the account is applied before determining how much is due for that invoice (the amount that will be actually charged). If the amount due for the invoice is less than 50 cents (the minimum for a charge), we add the amount to the customer's running account balance to be added to the next invoice. If this amount is negative, it will act as a credit to offset the next invoice. Note that the customer account balance does not include unpaid invoices; it only includes balances that need to be taken into account when calculating the amount due for the next invoice.
customerId | The customer to create the invoice for |
---|---|
applicationFee | A fee in cents that will be applied to the invoice and transferred to the application owner’s Stripe account. |
description | The invoice description |
metadata | Arbitrary key-value pairs to attach to the invoice |
statementDescriptor | Extra information about a charge for the customer’s credit card statement. |
subscription | The ID of the subscription to invoice. If not set, the created invoice will include all pending invoice items for the customer. If set, the created invoice will exclude pending invoice items that pertain to other subscriptions. |
taxPercent | The percent tax rate applied to the invoice, represented as a decimal number. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Plan
id | Unique string of your choice that will be used to identify this plan when subscribing a customer. This could be an identifier like "gold" or a primary key from your own database. |
---|---|
amount | A positive integer in cents (or 0 for a free plan) representing how much to charge (on a recurring basis). |
currency | 3-letter ISO code for currency. |
interval | Specifies billing frequency. Either day, week, month or year. |
intervalCount | The number of intervals between each subscription billing. For example, interval=month and interval_count=3 bills every 3 months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks). |
planName | Name of the plan, to be displayed on invoices and in the web interface. |
trialPeriodDays | Specifies a trial period in (an integer number of) days. If you include a trial period, the customer won't be billed for the first time until the trial period ends. If the customer cancels before the trial period is over, she'll never be billed at all. |
statementDescriptor | An arbitrary string to be displayed on your customer's credit card statement. This may be up to22 characters. |
metadata | A set of key/value pairs that you can attach to a plan object. It can be useful for storing additional information about the plan in a structured format. |
StripeConnectorException | when there is an issue creating a Plan |
---|
Create a Refund When you create a new refund, you must specify a charge to create it on. Creating a new refund will refund a charge that has previously been created but not yet refunded. Funds will be refunded to the credit or debit card that was originally charged. The fees you were originally charged are also refunded. You can optionally refund only part of a charge. You can do so as many times as you wish until the entire charge has been refunded. Once entirely refunded, a charge can't be refunded again. This method will throw an error when called on an already-refunded charge, or when trying to refund more money than is left on a charge.
id | The identifier of the charge to be refunded. |
---|---|
amount | A positive integer in cents representing how much of this charge to refund. Can only refund up to the unrefunded amount remaining of the charge. |
refundApplicationFee | Boolean indicating whether the application fee should be refunded when refunding this charge. If a full charge refund is given, the full application fee will be refunded. Else, the application fee will be refunded with an amount proportional to the amount of the charge refunded. An application fee can only be refunded by the application that created the charge. |
reason | String indicating the reason for the refund. If set, possible values are duplicate, fraudulent, and requested_by_customer. Specifying fraudulent as the reason when you believe the charge to be fraudulent will help us improve our fraud detection algorithms. |
metadata | A set of key/value pairs that you can attach to a refund object. It can be useful for storing additional information about the refund in a structured format. You can unset an individual key by setting its value to null and then saving. To clear all keys, set metadata to null, then save. |
StripeConnectorException | when there is a problem with the Connector |
---|
Create a Subscription
createSubscriptionParameters | The Wrapped Subscription Parameters |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Delete a Card
ownerId | The ID of the owner of the card. |
---|---|
id | The ID of the card to be deleted. |
StripeConnectorException | when there is a problem with the Connector |
---|
Delete a Coupon
id | The ID of the coupon to be deleted. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Delete a Customer
id | The identifier of the customer to be deleted. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Delete a Plan
id | The id of the plan to delete |
---|
StripeConnectorException | when there is an issue deleting a Plan |
---|
List Active Subscriptions
customerId | The ID of the customer whose subscriptions will be retrieved |
---|---|
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
List All Application Fee Refunds You can see a list of the refunds belonging to a specific application fee. Note that the 10 most recent refunds are always available by default on the application fee object. If you need more than those 10, you can use this API method and the limit and starting_after parameters to page through additional refunds
id | The ID of the application fee whose refunds will be retrieved. |
---|---|
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
List all Application Fees
charge | Only return application fees for the charge specified by this charge ID. |
---|---|
createdTimestamp | A filter on the list based on the created field. The value can be a string with an integer Unix timestamp,... |
created | Or it can be a dictionary with the following options: gt, gte, lt, lte |
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
List all Balance History
listAllBalanceHistoryParameters | Wrapper object for list all balance history parameters |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
List All Bitcoin Receivers Returns a list of your receivers. Receivers are returned sorted by creation date, with the most recently created receivers appearing first.
active | Filter for active receivers. |
---|---|
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
filled | Filter for filled receivers. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
uncapturedFunds | Filter for receivers with uncaptured funds. |
StripeConnectorException | when there is a problem with the Connector |
---|
List all Charges
createdTimestamp | A filter on the list based on the object created field. The value can be a string with an integer Unix timestamp, |
---|---|
created | ... or it can be a dictionary with the following options: gt, gte, lt, lte |
customer | Only return charges for the customer specified by this customer ID. |
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
List all Coupons
listAllCouponsParameters | A wrapper class for the parameters |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
List all Customer Cards Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe. Stripe Connect is the recommended means for transferring funds.
ownerId | The ID of the customer whose cards will be retrieved |
---|---|
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
List all Customers
limit | A limit on the number of records to fetch in a batch |
---|---|
startingAfter | A cursor (id) for use in pagination. |
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. |
StripeConnectorException | when there is an issue listing customers |
---|
List All Events List events, going back up to 30 days.
createdTimestamp | A filter on the list based on the object created field. The value can be a string with an integer Unix timestamp |
---|---|
created | Or it can be a dictionary with the following options: gt, gte, lt, lte |
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
type | A string containing a specific event name, or group of events using * as a wildcard. The list will be filtered to include only events with a matching event property |
StripeConnectorException | when there is a problem with the Connector |
---|
List All Plans
listAllPlansParameters | An object that wraps the parameters for List All Plans |
---|
StripeConnectorException | when there is an issue listing plans |
---|
List All Refunds You can see a list of the refunds belonging to a specific charge. Note that the 10 most recent refunds are always available by default on the charge object. If you need more than those 10, you can use this API method and the limit and starting_after parameters to page through additional refunds.
chargeId | The ID of the charge whose refunds will be retrieved. |
---|---|
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
Pay an invoice
id | The invoice id |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve an Account's Details
id | The identifier of the account to be retrieved. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
List all Invoices
customerId | The id of the customer |
---|---|
dateTimestamp | A filter on the list based on the object date field. The value can be a string with an integer Unix timestamp,... |
date | Or it can be a dictionary with the following options: gt, gte, lt, lte |
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve an Application Fee
id | The identifier of the fee to be retrieved. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve an Application Fee Refund By default, you can see the 10 most recent refunds stored directly on the application fee object, but you can also retrieve details about a specific refund stored on the application fee.
id | The ID of the refund to retrieve |
---|---|
fee | ID of the Application Fee refunded |
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve the balance
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Balance Transaction
id | The id of the transaction |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Bitcoin Receiver Retrieves the Bitcoin receiver with the given ID.
id | The ID of the receiver to retrieve |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Card Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe. Stripe Connect is the recommended means for transferring funds.
ownerId | The ID of the owner of the card. |
---|---|
id | The ID of the card to be retrieved. |
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Charge
id | The identifier of the charge to be retrieved. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Coupon
id | The ID of the desired coupon. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Customer
id | The identifier of the customer to be retrieved. |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Event Retrieves the Event with the given ID
id | The ID of the desired event |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve an Invoice
id | The identifier of the desired invoice |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve an invoice's line items When retrieving an invoice, you'll get a lines property containing the total count of line items and the first handful of those items. There is also a URL where you can retrieve the full (paginated) list of line items.
id | The id of the invoice containing the lines to be retrieved |
---|---|
customer | In the case of upcoming invoices, the customer of the upcoming invoice is required. In other cases it is ignored. |
endingBefore | A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list. |
limit | A limit on the number of objects to be returned. Limit can range between 1 and 100 items. |
startingAfter | A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list. |
subscription | In the case of upcoming invoices, the subscription of the upcoming invoice is optional. In other cases it is ignored. |
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Plan
id | The id of the plan to retrieve |
---|
StripeConnectorException | when there is an issue retrieving a Plan |
---|
Retrieve a Refund By default, you can see the 10 most recent refunds stored directly on the charge object, but you can also retrieve details about a specific refund stored on the charge.
id | The identifier of the refund |
---|---|
chargeId | The identifier of the Charge refunded. |
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Subscription
customerId | The ID of the customer to create the subscription on |
---|---|
subscriptionId | ID of subscription to retrieve. |
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve a Token Retrieves the token with the given ID
id | The ID of the desired token |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Retrieve an upcoming invoice At any time, you can preview the upcoming invoice for a customer. This will show you all the charges that are pending, including subscription renewal charges, invoice item charges, etc. It will also show you any discount that is applicable to the customer. Note that when you are viewing an upcoming invoice, you are simply viewing a preview -- the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer's discount.
customerId | The identifier of the customer whose upcoming invoice you'd like to retrieve. |
---|---|
subscription | The identifier of the subscription for which you'd like to retrieve the upcoming invoice. If not provided, you will retrieve the next upcoming invoice from among the customer's subscriptions. |
StripeConnectorException | when there is a problem with the Connector |
---|
connectionStrategy |
---|
Update an Account You may only update accounts that you manage. To update your own account, you can currently only do so via the dashboard.
updateAccountParameters | Wrapper for the Update Account Parameters |
---|
StripeConnectorException | when there is a problem with the Connector |
---|
Update an Application Fee Refund Updates the specified application fee refund by setting the values of the parameters passed. Any parameters not provided will be left unchanged. This request only accepts metadata as an argument.
id | The identifier of the refund. |
---|---|
fee | The identifier of the Application Fee refunded |
metadata | A set of key/value pairs that you can attach to a refund object. It can be useful for storing additional information about the refund in a structured format. You can unset an individual key by setting its value to null and then saving. |
StripeConnectorException | when there is a problem with the Connector |
---|
Update a Card Note that this is only available for Customers at this time, as Recipients (of Transfers) have been deprecated by Stripe. Stripe Connect is the recommended means for transferring funds.
ownerId | The ID of the owner of the card. |
---|---|
id | The ID of the card to be updated. |
addressCity | The City component of the Card Address |
addressCountry | The Country component of the Card Address |
addressLine1 | The Address, Line 1, component of the Card Address |
addressLine2 | The Address, Line 2, component of the Card Address |
addressState | The State component of the Card Address |
addressZip | The Zipcode component of the Card Address |
expMonth | The Card's expiry month |
expYear | The Card's expiry year |
metadata | Arbitrary metadata to attach to the card |
cardName | The name for the card |
StripeConnectorException | when there is a problem with the Connector |
---|
Update a Charge Updates the specified charge by setting the values of the parameters passed. Any parameters not provided will be left unchanged. This request accepts only the description, metadata, receipt_emailand fraud_details as arguments.
id | The id of the charge to update |
---|---|
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. |
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 receipt_email is specified for a charge in live mode, a receipt will be sent regardless of your email settings. |
fraudDetails | A set of key/value pairs you can attach to a charge giving information about its riskiness. If you believe a charge is fraudulent, include a user_report key with a value of fraudulent. If you believe a charge is safe, include a user_report key with a value of safe. Note that you must refund a charge before setting the user_report to fraudulent. Stripe will use the information you send to improve our fraud detection algorithms. |
StripeConnectorException | when there is a problem with the Connector |
---|
Update a Coupon Updates the metadata of a coupon. Other coupon details (currency, duration, amount_off) are, by design, not editable.
id | The ID of the coupon to be updated. |
---|---|
metadata | A set of key/value pairs that you can attach to a coupon object. It can be useful for storing additional information about the coupon in a structured format. |
StripeConnectorException | when there is a problem with the Connector |
---|
Update a Customer. Updates the specified customer by setting the values of the parameters passed. Any parameters not provided will be left unchanged. For example, if you pass the card parameter, that becomes the customer's active card to be used for all charges in the future. When you update a customer to a new valid card: for each of the customer's current subscriptions, if the subscription is in the past_due state, then the latest unpaid, unclosed invoice for the subscription will be retried (note that this retry will not count as an automatic retry, and will not affect the next regularly scheduled payment for the invoice). (Note also that no invoices pertaining to subscriptions in the unpaid state, or invoices pertaining to canceled subscriptions, will be retried as a result of updating the customer's card.) This request accepts mostly the same arguments as the customer creation call.
id | The id of the Customer to update |
---|---|
accountBalance | An integer amount in cents that is the starting account balance for your customer. A negative amount represents a credit that will be used before attempting any charges to the customer’s card; a positive amount will be added to the next invoice. |
couponCode | If you provide a coupon code, the customer will have a discount applied on all recurring charges. Charges you create through the API will not have the discount. |
description | An arbitrary string that you can attach to a customer object. It is displayed alongside the customer in the dashboard. |
Customer’s email address. | |
metadata | A set of key/value pairs that you can attach to a customer object. It can be useful for storing additional information about the customer in a structured format. |
sourceToken | A token for a given source |
StripeConnectorException | when there is a problem with the Connector |
---|
Update an invoice
invoiceId | The invoice to update |
---|---|
applicationFee | A fee in cents that will be applied to the invoice and transferred to the application owner’s Stripe account. |
closed | Boolean representing whether an invoice is closed or not. To close an invoice, pass true. |
description | The invoice description |
forgiven | Boolean representing whether an invoice is forgiven or not. To forgive an invoice, pass true. Forgiving an invoice instructs us to update the subscription status as if the invoice were succcessfully paid. Once an invoice has been forgiven, it cannot be unforgiven or reopened. |
metadata | Arbitrary key-value pairs to attach to the invoice |
statementDescriptor | Extra information about a charge for the customer’s credit card statement. |
taxPercent | The percent tax rate applied to the invoice, represented as a decimal number. |
StripeConnectorException | when there is a problem with the Connector |
---|
Update a Plan
id | Of the plan to update |
---|---|
planName | Name of the plan, to be displayed on invoices and in the web interface. |
statementDescriptor | An arbitrary string to be displayed on your customer's credit card statement. This may be up to22 characters. |
metadata | A set of key/value pairs that you can attach to a plan object. It can be useful for storing additional information about the plan in a structured format. |
StripeConnectorException | when there is an issue updating a Plan |
---|
Update a Refund Updates the specified refund by setting the values of the parameters passed. Any parameters not provided will be left unchanged. This request only accepts metadata as an argument.
id | The identifier of the refund |
---|---|
chargeId | The identifier of the Charge refunded. |
metadata | A set of key/value pairs that you can attach to a refund object. It can be useful for storing additional information about the refund in a structured format. |
StripeConnectorException | when there is a problem with the Connector |
---|
Update a Subscription Note that Stripe uses a specific policy around prorating changed subscriptions. If you want to use this endpoint, consider the documentation at https://stripe.com/docs/api/java#update_subscription closely.
updateSubscriptionParameters | Wrapper for the complex Update Subscription Parameters |
---|
StripeConnectorException | when there is a problem with the Connector |
---|