Stripe
The Stripe modules enable you to create charges, customers, events, refunds, payouts, balances, payment intents, invoices, and invoice items in your Stripe account.
Getting Started with Stripe
Prerequisites
- A Stripe account
In order to use Stripe with Integromat, it is necessary to have a Stripe account. If you do not have one, you can create a Stripe account at www.stripe.com.
The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!
Connecting Stripe to Integromat
To connect your Stripe account to Integromat you need to obtain the API Key from your Stripe account and insert it in the Create a connection dialog in the Integromat module.
1. Log in to your Stripe account.
2. From the Dashboard, click Get your live API keys > Reveal Secret Key. For reference, test API Keys example is shown here.
3. Copy the Secret Key to your clipboard.
4. Go to Integromat and open the Stripe module's Create a connection dialog.
5. In the Connection name field, enter a name for the connection.
6. In the API Key field, enter the API copied in step 3, and click Continue.
The connection has been established.
Triggers
You do not have to add the webhooks in the Stripe as it is automatically done for you once you add and save an instant trigger module to your scenario.
Watch Events
Triggers when a given event occurs.
| Webhook Name | Enter a name for the webhook. |
| Connection | Establish a connection to your Stripe account. |
| Group | Select the group and the events which you want to watch. |
| Connect | Select the checkbox if you want this endpoint should receive events from connected accounts (true), or from your account (false). |
| Force different API Version | Enter the version of the API to which events to be sent that this endpoint will be generated with this Stripe Version instead of your account’s default Stripe Version. |
Universal
Make an API Call
Performs an arbitrary authorized API call.
| Connection | Establish a connection to your Stripe account. |
| URL | Enter a path relative to For the list of available endpoints, refer to the Stripe API Documentation. |
| Method | Select the HTTP method you want to use: GET POST PUT PATCH DELETE |
| Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
| Query String | Enter the request query string. |
| Body | Enter the body content for your API call. |
Example of Use - List Events
The following API call returns all the events from your Stripe account:
URL:/v1/events
Method:GET
Matches of the search can be found in the module's Output under Bundle > Body > data.
In our example, 10 events were returned:
Payment Intents
List Payment Intents
Retrieves a list of payment intents or filters by customer ID.
| Connection | Establish a connection to your Stripe account. |
| Customer ID | Enter the Customer ID whose payment intents you want to list. You can search the customer using their email address. |
| Limit | Set the maximum number of payment intents Integromat should return during one scenario execution cycle. |
Create a Payment Intent
Creates a Payment Intent.
| Connection | Establish a connection to your Stripe account. |
| Amount | Enter the amount to be collected by this Payment Intent. A positive integer representing how much to charge in the smallest currency unit. For example, 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency. The minimum amount is $0.50 US or equivalent in charge currency. The amount value supports up to eight digits. For example, a value of 99999999 for a USD charge of $999,999.99. |
| Currency | Enter the three-digit currency applicable for the payment intent. |
| Description | Enter the details of the payment intent. |
| Receipt Email | Enter the email address to which the payment intent recipient should be sent to. |
| Confirm this Payment Intent immediately | Select whether you want to confirm the payment intent immediately. |
| Payment Method Types | Select the payment methods for this payment intent. |
| Customer ID | Select the Customer ID to whom this payment intent receipt should go to. |
| Payment Method | Select the payment method:
|
| Line 1 | Enter the recipient's street address. |
| Line 2 | Enter the recipient's street address. |
| Postal Code | Enter the recipient's area postal code. |
| City | Enter the recipient's city name. |
| State | Enter the recipient's state name. |
| Country Code | Enter the recipient's country code. |
| Recipient Name | Enter the recipient's name. |
| Carrier | Enter the courier service name. For example, FedEx. |
| Phone | Enter the recipient's phone number. |
| Tracking Number | Enter the courier tracking number. |
| Statement Descriptor | Enter the details of the payment intent. For non-card charges, you can use this value as the complete description that appears on your customers’ statements. A maximum of 22 characters is allowed. |
| Statement Descriptor Suffix | Enter the statement details that appear on the customer's statement. Concatenated with the statement descriptor prefix and statement descriptor to form the complete statement descriptor. A maximum of 22 characters is allowed. |
| Idempotency Key | Enter the ID that you associate with the cart or customer session in your application - when creating the Payment Intent to avoid erroneously creating duplicate Payment Intents for the same purchase. |
| Capture Method | Select the payment intent capture method:
|
| Confirmation Method | Select the payment intent confirmation method:
|
| Use Stripe SDK | Select whether you want to Stripe SDK for sending a confirmation about the payment intent. This is applicable only for Stripe Connect and only when using iOS or Android SDKs to handle additional authentication steps. |
| Transfer Group | Enter the transfer group associated with the payment intent. This field is only applicable if you are using Stripe Connect. |
| Application Fee Amount | Enter the application fee amount for the payment intent. This is applicable for Stripe Connect Only. For more information, see the Payment Intents use case for connected accounts. |
| On Behalf Of | Enter the Stripe Account ID to whom the payment intent belongs. This field is for Stripe Connect Only. For more information, see the Payment Intents use case for connected accounts. |
| Destination | Enter the destination account details. |
| Amount | Enter the amount of this payment intent to send to the destination account. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
Retrieve a Payment Intent
Retrieves the details of a Payment Intent that has previously been created.
| Connection | Establish a connection to your Stripe account. |
| Payment Intent ID | Select the Payment Intent ID whose details you want to retrieve. You can find the Payment Intent ID on the Payments page. |
Confirm a Payment Intent
Confirms a payment intent by its ID. Upon confirmation, the payment intent will attempt to initiate a payment.
| Connection | Establish a connection to your Stripe account. |
| Payment Intent ID | Select the Payment Intent ID whose details you want to retrieve. You can find the Payment Intent ID on the Payments page. |
| Receipt Email | Enter the email address to which the payment intent recipient should be sent to. |
| Payment Method | Select the payment method option to attach to this Payment Intent:
|
| Payment Method ID | Select the Payment Method ID to attach to the payment intent. |
| Setup Future Usage | Providing this parameter will attach the payment method to the Payment Intent’s Customer if present, after the Payment Intent, is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be attached to a Customer after the transaction completes. |
| Type | Select the payment method. For example, Alipay. |
| Line 1 | Enter the recipient's billing street address. |
| Line 2 | Enter the recipient's billing street address. |
| Postal Code | Enter the recipient's area postal code. |
| City | Enter the recipient's city name. |
| State | Enter the recipient's state name. |
| Country Code | Enter the recipient's country code. |
| Enter the billing address contact's email address. | |
| Name | Enter the billing address contact's name. |
| Phone | Enter the billing address phone number. |
| Metadata | Add a set of Key-Pair values for the payment intent. |
| Line 1 | Enter the recipient's shipping street address. |
| Line 2 | Enter the recipient's street address. |
| Postal Code | Enter the recipient's area postal code. |
| City | Enter the recipient's city name. |
| State | Enter the recipient's state name. |
| Country Code | Enter the recipient's country code. |
| Recipient Name | Enter the recipient's name. |
| Carrier | Enter the courier service name. For example, FedEx. |
| Phone | Enter the recipient's phone number. |
| Tracking Number | Enter the courier tracking number. |
| Payment Method Types | Select the payment methods for this payment intent. For example, card, SOFORT. |
| Preferred Languages | Select the preferred language for the Bancontact payment method. |
| Enabled | Select whether the payment installation configuration is enabled for this payment intent. This applies only to Mexico Only. For more information, see the installments integration guide. |
| Network | Select the payment network. For example, American Express. |
| Request 3D Secure | Select the option for 3D secure payment:
Stripe strongly recommends that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your fraud engine, provide this option. Read the guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and the SCA Engine. |
| Preferred Language | Select the preferred language for the SOFORT payment method. |
| Off Session | Select whether the customer is not in your checkout flow during this payment attempt, and therefore is unable to authenticate. This parameter is intended for scenarios where you collect card details and charge them later. |
| Error On Requires Act-On | Select whether to fail the payment attempt if the Payment Intent transitions into requires action. This parameter is intended for simpler integrations that do not handle customer actions, like saving cards without authentication. |
| Mandate | Select an option to mandate the payment intent:
|
| Mandate ID | Enter the Mandate ID to be used for this payment only. The ID is your account's secret key. |
| Type | Select the mandate type:
|
| IP Address | Enter the IP address from which the Mandate was accepted by the customer. |
| User Agent | Enter the user agent of the browser from which the Mandate was accepted by the customer. |
| Accepted At | Enter the time at which the customer has accepted the mandate. |
| Return URL | Enter the URL address to redirect the customer back to after they authenticate or cancel their payment on the payment method’s app or site. If you prefer to redirect to a mobile application, you can alternatively supply an application URI scheme. |
Capture a Payment Intent
Captures an existing uncaptured payment intent by its ID.
| Connection | Establish a connection to your Stripe account. |
| Payment Intent ID | Enter the Payment Intent ID you want to capture. You can search for the payment Intent ID using Customer ID. |
| Amount to Capture | Enter the amount to capture from the Payment Intent. The amount must be less than or equal to the original amount. Any additional amount will be automatically refunded. Defaults to the full amount_capturable if not provided. |
| Statement Descriptor | Enter the details of the payment intent that appears on the card statement. For non-card charges, you can use this value as the complete description that appears on your customers’ statements. The description must be at most 22 characters long. |
| Statement Descriptor Suffix | Enter the details of the payment intent that appears on the card statement. For non-card charges, you can use this value as the complete description that appears on your customers’ statements. Must be at most 22 characters long. |
| Application Fee Amount | Enter the amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner’s Stripe account. The amount of the application fee collected will be capped at the total payment amount. This is applicable for Stripe Connect only. For more information, see the Payment Intents use case for connected accounts. |
| Amount | The amount that will be transferred automatically when a charge succeeds. The amount is capped at the total transaction amount and if no amount is set, the full amount is transferred. |
Update a Payment Intent
Updates the specified payment intent by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Payment Intent ID | Select the Payment Intent ID whose details you want to retrieve. You can find the Payment Intent ID on the Payments page. |
| Amount | Enter the amount to charge in the smallest currency unit. For example, 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency. The minimum amount is $0.50 US or equivalent in charge currency. The amount must be lower than or equal to 99999999. |
| Receipt Email | Enter the email address to which the payment intent recipient should be sent to. |
| Payment Method | Select the payment method option to attach to this Payment Intent:
|
| Payment Method ID | Select the Payment Method ID to attach to the payment intent. |
| Setup Future Usage | Providing this parameter will attach the payment method to the Payment Intent’s Customer if present, after the Payment Intent, is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be attached to a Customer after the transaction completes. |
| Type | Select the payment method. For example, |
| Line 1 | Enter the recipient's billing street address |
| Line 2 | Enter the recipient's billing street address. |
| Postal Code | Enter the recipient's area postal code. |
| City | Enter the recipient's city name. |
| State | Enter the recipient's state name. |
| Country Code | Enter the recipient's country code. |
| Enter the billing address contact's email address. | |
| Name | Enter the billing address contact's name. |
| Phone | Enter the billing address phone number. |
| Metadata | Add a set of Key-Pair values for the payment intent. |
| Line 1 | Enter the recipient's shipping street address. |
| Line 2 | Enter the recipient's street address. |
| Postal Code | Enter the recipient's area postal code. |
| City | Enter the recipient's city name. |
| State | Enter the recipient's state name. |
| Country Code | Enter the recipient's country code. |
| Recipient Name | Enter the recipient's name. |
| Carrier | Enter the courier service name. For example, FedEx. |
| Phone | Enter the recipient's phone number. |
| Tracking Number | Enter the courier tracking number. |
| Payment Method Types | Select the payment methods for this payment intent. For example, card, SOFORT. |
| Preferred Languages | Select the preferred language for the Bancontact payment method. |
| Enabled | Select whether the payment installation configuration is enabled for this payment intent. This applies only to Mexico Only. For more information, see the installments integration guide. |
| Network | Select the payment network. For example, American Express. |
| Request 3D Secure | Select the option for 3D secure payment:
Stripe strongly recommends that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your fraud engine, provide this option. Read the guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and the SCA Engine. |
| Preferred Language | Select the preferred language for the SOFORT payment method. |
| Off Session | Select whether the customer is not in your checkout flow during this payment attempt, and therefore is unable to authenticate. This parameter is intended for scenarios where you collect card details and charge them later. |
| Error On Requires Act-On | Select whether to fail the payment attempt if the Payment Intent transitions into requires action. This parameter is intended for simpler integrations that do not handle customer actions, like saving cards without authentication. |
| Mandate | Select an option to mandate the payment intent:
|
| Mandate ID | Enter the Mandate ID to be used for this payment only. The ID is your account's secret key. |
| Type | Select the mandate type:
|
| IP Address | Enter the IP address from which the Mandate was accepted by the customer. |
| User Agent | Enter the user agent of the browser from which the mandate was accepted by the customer. |
| Accepted At | Enter the time at which the customer has accepted the mandate. |
| Return URL | Enter the URL address to redirect the customer back to after they authenticate or cancel their payment on the payment method’s app or site. If you prefer to redirect to a mobile application, you can alternatively supply an application URI scheme. |
Capture a Payment Intent
Captures an existing uncaptured payment intent by its ID.
| Connection | Establish a connection to your Stripe account. |
| Payment Intent ID | Enter the Payment Intent ID you want to capture. You can search for the payment Intent ID using Customer ID. |
| Amount to Capture | Enter the amount to capture from the Payment Intent. The amount must be less than or equal to the original amount. Any additional amount will be automatically refunded. Defaults to the full amount_capturable if not provided. |
| Statement Descriptor | Enter the details of the payment intent that appears on the card statement. For non-card charges, you can use this value as the complete description that appears on your customers’ statements. Must be at most 22 characters long. |
| Statement Descriptor Suffix | Enter the details of the payment intent that appears on the card statement. For non-card charges, you can use this value as the complete description that appears on your customers’ statements. Must be at most 22 characters long. |
| Application Fee Amount | Enter the amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner’s Stripe account. The amount of the application fee collected will be capped at the total payment amount. This is applicable for Stripe Connect only. For more information, see the Payment Intents use case for connected accounts. |
| Amount | The amount that will be transferred automatically when a charge succeeds. The amount is capped at the total transaction amount and if no amount is set, the full amount is transferred. |
Cancel a Payment Intent
Cancels a payment intent by its ID. For Payment.
| Connection | Establish a connection to your Stripe account. |
| Payment Intent | Enter the Payment Intent ID you want to delete. You can search for the payment Intent ID using customer ID through their email address. |
Customers
Search Customers
Retrieves a list of customers filtered by criteria.
| Connection | Establish a connection to your Stripe account. |
| Enter the customer's email address. | |
| Filter | Select the filters to search the customer based on the selected option. For example, created date. |
| Limit | Set the maximum number of customers Integromat should return during one scenario execution cycle. |
List All Customers
Retrieves a list of customers.
| Connection | Establish a connection to your Stripe account. |
| Enter the email address to list the customers with the specified email. | |
| Created At | Select the filters to search the customer based on the selected option. For example, before. |
| Timestamp | Enter the date and time to list the customer created on, before, or after the specified time. |
| Limit | Set the maximum number of customers Integromat should return during one scenario execution cycle. |
Create a Customer
Creates a new Customer object.
| Connection | Establish a connection to your Stripe account. |
| Description | Enter the details of the customer. |
| Enter the customer's email address. | |
| Name | Enter the customer's name. |
| Phone | Enter the customer's phone number |
| Line 1 | Enter the customer's shipping street address. |
| Line 2 | Enter the customer's shipping street address. |
| Postal Code | Enter the customer's area postal code. |
| City | Enter the customer's city name. |
| State | Enter the customer's state name. |
| Country | Enter the customer's country name. |
| Name | Enter the contact's name at the shipping address. |
| Phone | Enter the shipping address contact phone number. |
| Payment Method ID | Enter the customer's Payment Method ID. |
| Metadata | Add a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. |
| Balance | Enter an integer amount in paise/cents that represent the customer’s current balance. This amount affects the customer’s future invoices. A negative amount represents a credit that decreases the amount due on an invoice; a positive amount increases the amount due on an invoice. |
| Coupon ID | Enter the customer's Coupon ID. 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 a discount. |
| Invoice Prefix | Enter the prefix for the customer used to generate unique invoice numbers. The prefix must be 3–12 uppercase letters or numbers. |
| Custom Fields | Add the custom fields and values for the customer. For example, Permanent Address. |
| Default Payment Method ID | Enter the default Payment Method ID of the customer. This is used in customer's invoices. |
| Footer | Enter the information that appears in the footer of the invoice. |
| Next Invoice Sequence | Enter the sequence to be used on the customer's next invoice. |
| Preferred Locales | Add the customer's preferred communication languages. |
| Promotion Code ID | Enter the customer's Promotion Code ID used to avail discounts. The customer will have a discount applied on all recurring payments. Charges created through the API will not have a discount. |
| Source ID | Enter the Source ID from where the customer is registering with. When using payment sources created via the Token or Sources APIs, the passing source will create a new source object, make it the new customer default source, and delete the old customer default if one exists. |
| Tax Exempt | Select the tax exemption option applicable for the customer:
|
| TAX ID Data | Add the customer's Tax ID data: Type Select the tax type. For example, EU-VAT. Tax ID Enter the customer's Tax ID. |
Retrieve a Customer
Retrieves the details of an existing customer.
| Connection | Establish a connection to your Stripe account. |
| Customer ID | Select the Customer ID whose details you want to retrieve. |
Update a Customer
Updates a specified customer by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Customer ID | Select the Customer ID whose details you want to update. |
See the Create a Customer for field descriptions.
Delete a Customer
Permanently deletes a customer. It cannot be undone.
| Connection | Establish a connection to your Stripe account. |
| Customer ID | Select the Customer ID you want to delete. |
Refunds
List All Refunds
Returns a list of all refunds you've previously created.
| Connection | Establish a connection to your Stripe account. |
| Charge | Select the charge whose refunds you want to list. |
| Limit | Set the maximum number of refunds Integromat should return during one scenario execution cycle. |
Create a Refund
Creates a new refund.
| Connection | Establish a connection to your Stripe account. |
| Charge | Select the charge for which you want to create a refund. |
| Amount | Enter the amount to be refunded. A positive integer in the smallest currency unit. For example, 100 cents to charge $1.00 or 100 to charge ¥100, a 0-decimal currency representing the amount to refund. You can only refund up to the unrefunded amount remaining of the charge. |
| Reason | Select the reason for the refund. For example, duplicate. |
| Refund Applicable Fee | Select 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. Otherwise, the application fee will be refunded in an amount proportional to the amount of the charge refunded. |
| Reverse Transfer | Select whether the transfer should be reversed when refunding this charge. The transfer will be reversed proportionally to the amount being refunded (either the entire or partial amount). A transfer can be reversed only by the application that created the charge. |
| Metadata | Enter a set of key-value pairs that you can attach to a Refund object. This can be useful for storing additional information about the refund in a structured format. You can unset individual keys if you POST an empty value for that key. You can clear all keys if you POST an empty value for metadata. |
Retrieve a Refund
Retrieves the details of an existing
| Connection | Establish a connection to your Stripe account. |
| Refund | Enter the refund identifier whose details you want to retrieve. |
Update a Refund
Updates the specified payout by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Refund | Select the charge for which you want to create a refund. |
| Metadata | Enter a set of key-value pairs that you can attach to a Refund object. This can be useful for storing additional information about the refund in a structured format. You can unset individual keys if you POST an empty value for that key. You can clear all keys if you POST an empty value for metadata |
Payouts
List All Payouts
Returns a list of existing payouts sent to third-party bank accounts or that Stripe has sent you.
| Connection | Establish a connection to your Stripe account. |
| Destination | The ID of an external account - only return payouts sent to this external account. |
| Limit | Set the maximum number of payouts Integromat should return during one scenario execution cycle. |
| Created At | Select the filters to search the payouts based on the selected option. For example, before. |
| Timestamp | Enter the date and time to list the payouts created on, before, or after the specified time. See the list of supported date and time formats. |
| Arrival Date | Select the filters to search the payouts based on the selected option. For example, before. |
| Timestamp | Enter the date and time to list the payouts created on, before, or after the specified time. See the list of supported date and time formats. |
| Status | Select the status of the payout you want to list:
|
Create a Payout
To send funds to your own bank account. you create a new payout object.
| Connection | Establish a connection to your Stripe account. |
| Amount | Enter the payout amount. Enter a positive integer in the smallest currency unit. For example, 100 cents to charge $1.00 or 100 to charge ¥100, a 0-decimal currency representing how much to payout. |
| Currency | Enter the three-character currency applicable for the payout. For example, USD. |
| Description | Enter the details of the payout. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
| Method | The method used to send this payout:
The |
| Source Type | Select the source for payout. For example, Bank account, card, Alipay account. |
| Statement Descriptor | Enter the information that appears on the customer's statement. |
Cancel a Payout
Cancels a previously created payout.
| Connection | Establish a connection to your Stripe account. |
| Payout | Enter the payout identifier you want to cancel. |
Retrieve a Payout
Retrieves the details of an existing payout.
| Connection | Establish a connection to your Stripe account. |
| Payout | Enter the payout identifier whose details you want to retrieve. |
Update a Payout
Updates the specified payout by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Payout | Enter the payout identifier you want to update. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
Balance
Retrieve Balance
Retrieves the current account balance.
| Connection | Establish a connection to your Stripe account. |
List All Balance History
Returns a list of transactions that have contributed to the Stripe account balance.
| Connection | Establish a connection to your Stripe account. |
| Limit | Set the maximum number of balance histories Integromat should return during one scenario execution cycle. |
| Currency | Enter the three-character currency code to list the balance history for the selected currency. |
| Payout | Enter the Payout ID whose balance history you want to list. For automatic Stripe payouts only, it returns transactions that were paid out on the specified payout ID. |
| Type | Select the option whose balance history you want to list. For example, charge. |
| Created At | Select the filters to list the balance history based on the selected option. For example, before. |
| Created Timestamp | Enter the date and time to list the balance history created on, before, or after the specified time. See the list of supported date and time formats. |
| Available | Select the filters to list the balance history based on the selected option. For example, before. |
| Available Timestamp | Enter the date and time to list the balance history available on, before, or after the specified time. See the list of supported date and time formats. |
Retrieve a Balance Transaction
Retrieves the balance transaction with the given ID.
| Connection | Establish a connection to your Stripe account. |
| ID | Enter the identifier of the balance transaction to be retrieved. Usually starts with txn_ |
Invoices
Search Invoices
Retrieves a list of invoices filtered by criteria.
| Connection | Establish a connection to your Stripe account. |
| List By | Select the option to list the invoices:
|
| Customer ID | Enter the Customer ID whose invoices you want to list. |
| Invoice ID | Enter the Invoice ID whose details you want to list. |
| Pending | Select whether to list only the pending invoices. |
| Filter | Select the filters to list the invoices based on the selected option. For example, created date. |
| Limit | Set the maximum number of invoices Integromat should return during one scenario execution cycle. |
List All Invoice Line Items
Retrieves a list of invoice line items by the invoice ID.
| Connection | Establish a connection to your Stripe account. |
| Invoice ID | Enter the Invoice ID whose line items you want to list. |
| Limit | Set the maximum number of invoices Integromat should return during one scenario execution cycle. |
Create an Invoice
Creates a new invoice by the customer ID.
| Connection | Establish a connection to your Stripe account. |
| Customer ID | Select the Customer ID for whom invoice you want to create the invoice. |
| Auto Advance | Select whether you want Stripe to perform an automatic collection of the invoice. When left unselected, the invoice’s state will not automatically advance without explicit action. |
| Collection Method | Select the option for invoice collection method:
|
| Days Until Due | Enter the number of days from when the invoice is created until it is due. Applicable only when the collection method is selected as Send Invoices. |
| Due Date | Enter the date on which the payment for the invoice is due. Applicable only when collection method is Send Invoices. |
| Description | Enter the invoice details. |
| Subscription ID | Enter the Subscription ID of the invoice. If left blank, the created invoice will include all pending invoice items for the customer. If set, the created invoice will only include pending invoice items for that subscription and pending invoice items not associated with any subscription. The subscription’s billing cycle and regular subscription events won’t be affected. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
| Application Fee Amount | Enter the application fee in cents that will be applied to the invoice and transferred to the application owner’s Stripe account. The request must be made with an OAuth key or the Stripe-Account header to take an application fee. For more information, see the application fees documentation. |
| Custom Fields | Add the custom fields for the invoice: Enter the name of the custom field. You can enter a maximum of 30 characters. Enter the value of the custom field. You can enter a maximum of 30 characters. |
| Default Payment Method ID | Enter the default payment method ID for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription’s default payment method, if any, or to the default payment method in the customer’s invoice settings. |
| Default Tax Rates ID | Enter the Default Tax Rate ID. |
| Discounts | Add the discounts applicable for the invoice: Coupon ID Select the Coupon ID applicable for the invoice. Discount ID Enter an existing discount ID on the object (or one of its ancestors) to reuse. |
| Footer | Enter the text that appears at the footer of the invoice. |
| Statement Descriptor | Enter the text that appears in the customer's invoice statement. If not specified and this invoice is part of a subscription, the default statement_descriptor will be set to the first subscription item’s product’s statement_descriptor. |
| Destination | Enter the account to which the invoice amount to be transferred. |
| Amount | Enter the amount to be transferred. |
Retrieve an Invoice
Retrieves the details of an existing invoice with the given ID.
| Connection | Establish a connection to your Stripe account. |
| Invoice ID | Select the Invoice ID whose details you want to retrieve. |
Update an Invoice
Updates the specified invoice by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Invoice ID | Select the Invoice ID whose details you want to update. You can search the invoices by Customer ID, Subscription ID, Status, and Collection Method |
| Auto Advance | Select whether you want Stripe to perform an automatic collection of the invoice. When left unselected, the invoice’s state will not automatically advance without explicit action. |
| Collection Method | Select the option for invoice collection method:
|
| Days Until Due | Enter the number of days from when the invoice is created until it is due. Applicable only when the collection method is selected as Send Invoices. |
| Due Date | Enter the date on which the payment for the invoice is due. Applicable only when collection method is Send Invoices. |
| Description | Enter the invoice details. |
| Subscription ID | Enter the Subscription ID of the invoice. If left blank, the created invoice will include all pending invoice items for the customer. If set, the created invoice will only include pending invoice items for that subscription and pending invoice items not associated with any subscription. The subscription’s billing cycle and regular subscription events won’t be affected. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
| Application Fee Amount | Enter the application fee in cents that will be applied to the invoice and transferred to the application owner’s Stripe account. The request must be made with an OAuth key or the Stripe-Account header to take an application fee. For more information, see the application fees documentation. |
| Custom Fields | Add the custom fields for the invoice: Enter the name of the custom field. You can enter a maximum of 30 characters. Enter the value of the custom field. You can enter a maximum of 30 characters. |
| Default Payment Method ID | Enter the default payment method ID for the invoice. It must belong to the customer associated with the invoice. If not set, defaults to the subscription’s default payment method, if any, or to the default payment method in the customer’s invoice settings. |
| Default Tax Rates ID | Enter the Default Tax Rate ID. |
| Discounts | Add the discounts applicable for the invoice: Coupon ID Select the Coupon ID applicable for the invoice. Discount ID Enter an existing discount ID on the object (or one of its ancestors) to reuse. |
| Footer | Enter the text that appears at the footer of the invoice. |
| Statement Descriptor | Enter the text that appears in the customer's invoice statement. If not specified and this invoice is part of a subscription, the default statement_descriptor will be set to the first subscription item’s product’s statement_descriptor. |
| Destination | Enter the account to which the invoice amount to be transferred. |
| Amount | Enter the amount to be transferred. |
Finalize a Draft Invoice
Finalizes a draft invoice by its ID.
| Connection | Establish a connection to your Stripe account. |
| Invoice ID | Select the draft Invoice ID you want to finalize. |
Void an Invoice
Voids a finalized invoice with the given ID. This cannot be undone.
| Connection | Establish a connection to your Stripe account. |
| Invoice ID | Select the Invoice ID you want to void. |
Delete a Draft Invoice
Permanently deletes a drat invoice. Use the Void an Invoice module for a finalized invoice.
| Connection | Establish a connection to your Stripe account. |
| Invoice ID | Select the draft Invoice ID you want to delete. |
Invoice Items
Search Invoice Items
Retrieves a list of invoice items filtered by criteria.
| Connection | Establish a connection to your Stripe account. |
| List By | Select the option to list the invoice items:
|
| Customer ID | Enter the Customer ID whose invoice items you want to list. |
| Invoice ID | Enter the Invoice ID whose invoice items you want to list. |
| Pending | Select whether to list only the pending invoice items. |
| Filter | Select the filters to list the invoice items based on the selected option. For example, created date. |
| Limit | Set the maximum number of invoice items Integromat should return during one scenario execution cycle. |
Create an Invoice Item
Creates a new invoice item to be added to a draft invoice.
| Connection | Establish a connection to your Stripe account. |
| Customer ID | Enter the Customer ID whose invoice item you want to create. |
| Input an Amount | Select the option to input the invoice amount:
|
| Amount | Enter the invoice item amount. Enter the cents of the charge to be applied to the upcoming invoice. Passing in a negative amount will reduce the amount_due on the invoice. |
| Price Object | Select the price object option:
|
| Product ID | Select the Product ID whose items invoice you are creating. |
| Price ID | Enter the Price ID of the price object. |
| Quantity | Enter the number of items to add to the invoice. |
| Currency | Enter the three-character currency code applicable to the invoice. For example, USD. |
| Description | Enter the description of the invoice to display in the invoice for easy tracking. |
| Start | Enter the start date of the time period for the invoice. See the list of supported date and time formats. |
| End | Enter the last of the time period for the invoice and it must be greater than or equal to the start. See the list of supported date and time formats. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
| Discountable | Select whether discounts apply to this invoice item. Defaults to false for prorations or negative invoice items, and true for all other invoice items. Cannot be set to true for prorations. |
| Tax Rates ID | Enter the tax rates which apply to the invoice item. When set, the default_tax_rates on the invoice does not apply to this invoice item. Pass an empty string to remove previously-defined tax rates. |
Retrieve an Invoice Item
Retrieves the details of an existing invoice item with the given ID.
| Connection | Establish a connection to your Stripe account. |
| Invoice Item ID | Enter the Invoice Item ID whose details you want to retrieve. |
Update an Invoice Item
Updates the specified invoice item by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Invoice Item ID | Enter the Invoice Item ID whose details you want to update. |
| Input an Amount | Enter an amount in paise/cents of the charge to be applied to the upcoming invoice. If you want to apply a credit to the customer’s account, pass a negative amount. |
| Description | Enter the description of the invoice to display in the invoice for easy tracking. |
| Start | Enter the start date of the time period for the invoice. See the list of supported date and time formats. |
| End | Enter the last of the time period for the invoice and it must be greater than or equal to the start. See the list of supported date and time formats. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
| Discountable | Select whether discounts apply to this invoice item. Defaults to false for prorations or negative invoice items, and true for all other invoice items. Cannot be set to true for prorations. |
| Tax Rates ID | Enter the tax rates which apply to the invoice item. When set, the default_tax_rates on the invoice does not apply to this invoice item. Pass an empty string to remove previously-defined tax rates. |
Delete an Invoice Item
Permanently deletes an invoice item that is not attached to invoices, or if it's attached to a draft invoice.
| Connection | Establish a connection to your Stripe account. |
| Invoice Item ID | Enter the Invoice Item ID you want to delete. |
Charges
List All Charges
Returns a list of charges you've previously created. The changes are returned in sorted order, with the most recent charges appearing first.
| Connection | Establish a connection to your Stripe account. |
| Customer | Select the customer whose charges you want to list. |
| Limit | Set the maximum number of charges Integromat should return during one scenario execution cycle. |
| Created At | Select the filter for time and enter the timestamp for which you want to list the charges. For example, if you select the filter as before and the date as 2021-11-02, then the charges before the date will be returned. |
| Source | Select the source to list the charges based on the specified source. |
| Transfer Group | Enter the transfer group to list the charges related to the specified group. This field is only applicable if you are using Stripe Connect. |
Create a Charge
Creates a charge.
| Connection | Establish a connection to your Stripe account. |
| Amount | Enter the amount to be charged. |
| Currency | Enter a three-digit currency code applicable for the charge. For example, USD. |
| Capture | Select 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 | Enter the details of the charge. |
| Customer | Enter the ID of an existing customer who will be charged in this request. |
| Source | Enter a payment source to be charged. For example, this can be the ID of a credit card or debit card, a bank account, a source, a token, or a connected account. For certain sources—namely, cards, bank accounts, and attached sources—you must also pass the ID of the associated customer. |
Capture a Charge
Capture the payment of an existing uncaptured charge.
| Connection | Establish a connection to your Stripe account. |
| Charge to Capture | Enter the Charge ID you want to capture. You can find the charge details on your account's payment page. |
| Amount | Enter the amount charged. A positive integer in the smallest currency unit, For example, 100 cents to charge $1.00 or 100 to charge ¥100, a 0-decimal currency representing how much to capture. The amount to capture, which must be less than or equal to the original amount. Any additional amount will be automatically refunded. |
| Statement Descriptor | Enter the details of the charge. |
| Application Fee | Enter an application fee to add to this charge. This can only be used with Stripe Connect. |
| Amount | The portion of this charge to send to the destination account. |
| Receipt Email | Enter the receipt's email address. This will override the previously-specified email address for this charge if one was set. |
Retrieve a Charge
Retrieves the details of a charge that has previously been created.
| Connection | Establish a connection to your Stripe account. |
| Charge | Enter the Charge ID you want to capture. You can find the charge details on your account's payment page. |
| Application Fee | Select the checkbox to retrieve the application fee along with the charge details. |
Update a Charge
Updates the specified charge by setting the values of the parameters passed.
| Connection | Establish a connection to your Stripe account. |
| Charge | Enter the Charge ID whose details you want to update. |
| Customer | Select the customer associated with the charge. |
| Description | Enter the charge details. |
| Fraud Details | Enter a set of key-value pairs to attach to a charge giving information about its risk. 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. Stripe will use the information you send to improve our fraud detection algorithms. |
| Metadata | Enter a set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata. |
| Receipt Mail | Enter the email address to which the receipt for this charge will be sent. |
| City | Enter the recipient's city name. |
| Country | Enter the recipient's country name. |
| Line 1 | Enter the recipient's street address. |
| Line 2 | Enter the recipient's street address. |
| Postal Code | Enter the recipient's area postal code. |
| State | Enter the recipient's state name. |
| Carrier | Enter the courier details. For example, FedEx. |
| Name | Enter the recipient's name. |
| Phone | Enter the recipient's phone numbers. |
| Tracking Number | Enter the courier tracking number. |
| Transfer Group | Enter the transfer group associated with the charge. This field is only applicable if you are using Stripe Connect. |
