Tutorial
...
Stripe Integration
Collect Payments via Stripe Invoicing
39 min
nue's billing accelerator simplifies the invoicing and collection workflow for businesses by seamlessly integrating with stripe invoicing https //stripe com/invoicing?utm campaign=amer us en google search brand invoicing exa phr 21577103516\&utm medium=cpc\&utm source=google\&ad content=708825310445\&utm term=stripe%20invoicing\&utm matchtype=e\&utm adposition=\&utm device=c\&gad source=1\&gad campaignid=21577103516\&gbraid=0aaaaadknro72cutzy0x7lecf4r0jhi zu\&gclid=cj0kcqjw0ldbbhcnarisampylaret0m4knyzkwo5srdxijy9hufasejqtr1nxagtlprx1sivexvaxe0aanquealw wcb by effortlessly generating invoices from orders and smoothly transferring them to stripe for payment processing, nue ensures a streamlined experience when customers settle their invoices via stripe, either by using the stripe hosted payment link in the invoice email or through automatic credit card charges, nue automatically updates the corresponding invoice, marking the balance as paid this integration between nue and stripe presents businesses with an efficient and hassle free billing solution, empowering them to effectively manage their finances configure stripe integration please configure stripe integration by following steps in stripe integration setup docid 1kqyrvtbjmzvypqqcfdid under "collection preferences", select the option use stripe invoicing and stripe payments for payment collection docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 collection scenarios overview the stripe invoicing integration supports the following collection scenarios 💳 pay invoices when invoices are generated in nue by the billing engine, they are automatically sent to stripe an email with the attached invoice pdf is sent to the customer’s email address on file supports both one time payments recurring payments 🧾 issue credits when negative invoices or credit memos are generated in nue, they are automatically transferred to stripe as credits these credits are automatically applied by stripe to pay off future invoices when a credit note is manually issued on an invoice in stripe, nue records it as a credit applied to that invoice 💵 process non electronic payments customers may pay invoices via non electronic methods (e g , wire, check) finance operations can mark these invoices as “paid” in stripe, and payment status will sync back to nue ❌ cancel invoices when active invoices are canceled in nue, the corresponding invoices in stripe are voided automatically — and vice versa ➕ apply credit memos when a credit memo is applied to an invoice in nue, a matching credit note is issued to the invoice in stripe ➖ unapply credit memos if a credit memo is unapplied from an invoice in nue, the corresponding credit note in stripe is voided 💸 process refunds refunds processed in stripe automatically generate a credit memo or negative invoice in nue, ensuring both systems stay in sync 🕒 process late fees late fees created in nue (as debit memos for overdue invoices) are sent to stripe these late fees will appear on stripe invoices sent to customers docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 pay invoices scenario customer smart revenue inc purchases a 12 month subscription of vroom cloud storage with a total of $1200, billed monthly the first invoice is created on 05/16, with a payment term of 30 days customer receives the invoice via stripe, and pays in stripe a sales user creates a quote that includes the vroom cloud storage product line, which is finalized into an order once the order is activated, the first invoice is automatically generated and becomes visible in the lifecycle manager to ensure the first invoice is generated automatically upon order activation, make sure the billing setting “automatically generate first invoice when an order is activated” is enabled if this setting is disabled, you can manually run a billing schedule to generate the invoice to access and activate the invoice open the relevant account in salesforce click manage customer lifecycle select the activate icon next to the invoice you want to activate once activated, the invoice is transferred to stripe for payment processing click search to refresh the invoice list and view updated details payment status displays the current payment status possible values are transferred, paid, error (if the status is error, the payment details column will show the error message ) external invoice id contains the corresponding stripe invoice id linked to the invoice you can also click on the 'view' icon in the actions column to see the invoice details in salesforce in the invoice detail page, you can see the hosted payment page url the stripe hosted payment page is used to create a pre built, hosted payment page that can be used to collect payments online when a customer clicks on the link, they will be taken to the stripe hosted payment page the page will display the amount of the purchase and the payment methods that are available the customer can then enter their payment information and complete the purchase you can configure salesforce flows to include the hosted payment url in an email sent to the customer alternatively, you can configure stripe to automatically email the customer with the hosted payment page link included when the customer opens the payment page using the url, they’ll see the invoice details and can select from the available payment methods the available payment methods are determined by your default invoice settings in stripe at the time the invoice is created specify payment method sales users can select a specific payment method (e g , ach, credit card) during quote creation this selection is automatically carried over when the quote is finalized into an order when the associated invoice is billed and transferred to stripe, the selected payment method(s) will be enabled on the stripe hosted payment page for the customer to use if the invoice is generated from multiple orders, all payment methods specified across those orders will be available in the stripe payment page the image below shows the create order page where the payment method is selected — the same option is available on the create quote page docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 create customer with field mappings when an invoice is transferred to stripe for payment processing, nue first checks whether the corresponding customer already exists in stripe if not, nue automatically creates a new customer in stripe using the account details from nue by default, the newly created stripe customer will be populated with the following information from the nue account email taken from the order primary contact field billing address taken from the billing address on the account shipping address taken from the shipping address on the account you can also configure custom mappings between nue customer fields and stripe customer fields via create metadata mappings docid\ yhpjywdkgqdibfevr8bpm api once set up, nue will automatically populate the stripe customer record with data from the mapped nue fields for more information, please refer to stripe integration setup docid 1kqyrvtbjmzvypqqcfdid process payments once the customer receives the invoice with the hosted payment url and pays the invoice, the following occurs the invoice status is set to paid , in both stripe and nue the invoice balance is set to 0 in nue a payment application record is created under the invoice in nue, containing the payment details applly credit balance if a customer has an existing credit balance in their stripe account, the next invoice transferred to stripe will automatically reflect the credit being applied to reduce the outstanding amount in parallel, nue will create a corresponding payment application of type credit , linked to the invoice this payment application will offset the invoice balance within nue, ensuring both systems remain synchronized and providing a clear audit trail of credit usage across platforms docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 process recurring billing and payments with nue, you can configure a recurring billing schedule to automatically invoice customers on a defined cadence for instance, if a customer subscribes to a 12 month plan with monthly billing, nue will generate and activate an invoice each month, then transfer it to stripe for payment collection billing schedules in nue can be tailored to your needs whether daily, monthly, or a custom frequency and can be used to generate invoices for recurring products once activated, the schedule ensures that invoices are created and activated automatically at the defined intervals and transferred to stripe for seamless collections docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 automatic charge in this section, you can configure your preferred stripe collection method if you select automatically charge or smart collection , stripe will attempt to collect payment automatically using the customer’s saved ach or credit card information upon successful payment, the invoice status is updated to paid , and the invoice balance is cleared setup automatic charge in stripe when a payment method on file is automatically charged, stripe does not notify the customer by default if you want stripe to send an email receipt after a successful payment, ensure the “successful payments” email option is enabled in your stripe email settings , and that a valid customer email address is on file for more information, please check out stripe's documentation on automatic charging https //stripe com/docs/invoicing/automatic charging issue credits scenario customer smart revenue reduces 50% storage units for vroom cloud storage in the mid term company wants to issue a credit memo towards furture payments to implement this user scenario, first, you can create a change quote/order to reduce 50% of the storage unit of the subscription, and activate this order then you can run a billing schedule, which will generate a credit memo with prorated amounts for this change order if you do not enable credit memos, a negative invoice will be generated instead you can view the credit memos in the lifecycle manager the payment status shows whether it has been transferred successfully to stripe once the credit memo is transferred to stripe, it will be applied as a credit balance for the corresponding customer to view this log in to your stripe dashboard and navigate to customers open the customer record to see the updated credit balance this credit balance will be automatically applied toward future invoices for the same customer issue credit note in stripe you can also issue a credit note directly from the invoice in stripe to do this, follow these steps log in to the stripe dashboard find the invoice navigate to the customer’s invoices section, or use the top search bar to locate the invoice by number issue a credit note within the invoice details, go to the credit note section enter details specify the reason and credit amount, then click issue credit note once issued, nue will automatically create a payment application (credit type) linked to the invoice, which offsets the invoice balance accordingly process non electronic payments often times, companies want to process non electronic payments, for example when your customer is located in a country where electronic payments are not widely accepted there are many countries where electronic payments are not as common in these cases, you may need to accept cash or check payments when your customer is making a large purchase some customers may prefer to pay for large purchases with cash or check this is especially true if they are concerned about fraud or identity theft if a non electronic payment is received, finance ops can login to stripe, open the invoice, and click more > change invoice status, and set the status to paid with some additional internal notes, e g , check number once the invoice status is updated in stripe, nue will automatically do the following to the corresponding invoice record in nue change the payment status to paid; set the invoice balance to $0; create a payment application record cancel invoices and credit memos users can cancel invoices and credit memos both in nue and nue on salesforce, provided that sufficient permissions are granted cancel invoices when an active invoice is canceled in salesforce or nue, its corresponding invoice is voided in stripe when an unpaid invoice is canceled in stripe, its corresponding invoice is canceled in nue and salesforce occasionally, an incorrect order may be created, resulting in an invalid invoice that gets paid automatically through stripe either via a saved default credit card or an available credit balance in such cases, the invoice will appear as paid in both stripe and nue when you cancel a paid invoice, the system performs the following actions processes a refund for the electronic payment (e g , credit card) through stripe creates a credit back credit memo or negative invoice depending on if credit memos are enabled, along with corresponding negative payment applications (visible in both nue and nue on salesforce) cancels any related debit memos tied to the invoice in nue and salesforce updates the invoice status from active to canceled changes the invoice payment status from paid to refunded you can also cancel invoices that are in partially refunded or refunded status the following operations will be triggered based on the status use case 1 cancel a refunded invoice cancels all related debit memos in nue and salesforce updates the invoice status from active to canceled use case 2 cancel a partially refunded invoice processes the remaining refund in stripe creates a credit back credit memo or negative invoice and associated negative payment applications (in nue and salesforce) updates the invoice status to canceled changes the payment status from partially refunded to refunded note if you need to cancel the credit back credit memo or negative invoice created during the refund process, first cancel the original refunded invoice, then proceed to cancel the associated credit memo or negative invoice cancel credit memos when a credit memo is canceled in salesforce or nue, the credit balance of the customer in stripe is reduced by the same amount docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 apply credit memo finance operations users can choose to apply credit memos to a customer's invoices in nue since stripe does not support credit memos, after applying a credit memo to an invoice in nue, a corresponding credit note will be issued for that invoice in stripe finance operations users can also choose to unapply a credit memo from an invoice in nue in this case, the credit note associated with the invoice in stripe will be voided accordingly note please be aware that stripe does not permit voiding a credit note linked to a paid invoice therefore, unapplying a credit memo from a paid invoice in nue is also not allowed docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 process refund when finance ops users process refund of a particular payment issued to an invoice transfered from nue, nue will create a credit memo (or a negative invoice, if credit memo feature is not enabled) in nue to offset the original invoice the following diagram illustrates the transactions and their relationships in the refund process docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 issue refund in stripe you can follow the steps below to issue a refund to an invoice in stripe access the stripe dashboard log in to your stripe account at https //dashboard stripe com/ https //dashboard stripe com/ locate the payment navigate to the "payments" section or use the search functionality to find the specific payment for which you want to issue a refund open the payment details click on the payment to open its details initiate a refund within the payment details, locate the "refund" button or link, usually located near the transaction information specify the refund amount enter the amount you wish to refund to the customer it can be a full or partial refund choose refund method select the refund method based on your preferences and the original payment method used by the customer stripe allows you to refund directly to the customer's card, store the refund as a credit on their account, or issue an off session refund add refund reason (optional) you may have the option to include a reason for the refund, which can be helpful for record keeping purposes confirm and process refund double check the refund details and click the "refund" or "submit" button to process the refund stripe will initiate the refund process and handle the necessary transactions to return the funds to the customer confirmation and notifications once the refund is processed, you will receive a confirmation in the stripe dashboard, and stripe will automatically notify the customer via email or other preferred communication channels, depending on your account settings docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 access credit memo in nue after a refund is issued, you can access the credit memo generated in nue login to nue on salesforce open the account details, and click manage customer lifecycle to navigate to the lifecycle manager click 'credit memo' you can find the credit memo created with payment status credit back similar to payment operations, refund operations create payment application records with refund record type associated to the credit memo you can click the 'view' icon to open the credit memo details page to see the payment application records the payment status of the original invoice will be changed to refunded docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 partial refund finance ops users can process partial refund as well for each partial refund issued from stripe, a new credit memo record containing credit memo items will be created and linked to the original invoice the payment status of the original invoice will be changed to partially refunded docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 process late fees when an invoice is overdue, finance ops users can add a late fee in nue as a debit memo in late fees a debit memo use case docid\ n9cpwwbtvvqzerhttg1 t , you can learn about how to create and manage late fees as credit memos in nue, and how to get them collected in stripe in summary for each overdue invoice in nue, you can apply a late fee as a debit memo the debit memo record will be associated with the invoice the debit memo record will be transferred to stripe in stripe, the original invoice will be voided, and a new invoice will be created containing the original invoice items, as well as the late fee once the user pays for the invoice, 2 credit memo items will be created back in nue, one associated to the original invoice, the other one associated to the debit memo payment application records will be created accordingly as well docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 process zero amount invoices sometimes, customers may not need to pay for the services they have purchased because the services are already included in a bundle that has been paid or the usage of a service doesn't exceed the limit in such cases, nue will still generate an invoice with the amount $0 for that billing period however, there is no need to send such invoices to the customers administrators can enable the below setting to prevent the $0 amount invoices from being sent to stripe this ensures that customers do not receive any unnecessary invoices that do not require payment go to nue system settings > revenue manager > invoices or search for ' do not send invoices to collection systems with $0 total amount ' if the above setting is enabled and an invoice with a $0 amount is activated, it won't be sent to stripe automatically however, the revops manager can still choose to send it to stripe manually if necessary docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 docid 39907ab5a4ec3e0a1b644d44ebb18548b1420f20 troubleshoot payment transfer status in transaction hub at times, upon activating an invoice, it may encounter issues in its transfer to stripe in such instances, you have the option to use the transaction hub to review any encountered errors or initiate a re issuance of the transfer to stripe transaction hub in the complex landscape of finance and revenue operations, gaining a comprehensive understanding of billing transactions across various systems has been a challenge integrations with multiple external thrid party systems, spanning collection, accounting, taxation, and revenue recognition, adds layers of complexity it is critical to track the status of each transaction across these diverse platforms the transaction hub is a solution design to provide granular visibility into the transfer status of every transaction across disparate external systems serving as a centralized control point, transaction hub empowers authorized users to seamlessly initiate and monitor the transfer of transaction records with ease and efficiency please follow the steps below to access the transaction hub for invoices, and re issue a transfer to stripe login to {{nueapp}} , and navigate to revenue manager → invoices locate the 'transaction hub' column, as shown in the screenshot below this column shows the transfer statuses of invoices to corresponding systems, such as salesforce, stripe, quickbooks, avalara, etc if the icon appears greyed out, it indicates that the transaction has not yet been successfully transferred to the target system to check the transfer status, simply click on the icon if the icon displays a "transferred" status, you'll be presented with the nue id, external id, and last transferred time however, if the icon indicates a "not transferred" status, both the current transfer status and any associated error message will be shown in such cases, you have the option to manually re issue a transfer to stripe by clicking the 'transfer' icon
🤔
Have a question?
Get answers fast with Nue’s intelligent AI, expert support team, and a growing community of users - all here to help you succeed.
To ask a question or participate in discussions, you'll need to authenticate first.