Purpose
The Stripe Integration allows users to accept credit and debit card payments from customers directly in TRUE using Stripe as a built-in payment processing system. This integration provides seamless payment acceptance including support for the BBPOS WisePOS E card reader for in-person transactions. The integration also supports automatic credit card fee application and payment tracking within your invoicing workflow.
Setup & Configuration
Configure Stripe integration to accept credit card payments in TRUE
The Stripe integration settings are located in Company Preferences under the Integrations section. You will need a Stripe account with API access to complete the configuration.
Before configuring TRUE, you need to set up your Stripe account and obtain your API keys.
- Access the Stripe account dashboard at dashboard.stripe.com
- Navigate to Developers > API Keys
- Ensure Live Keys are enabled (not test keys)
- Copy the Secret key from the Stripe dashboard
Warning: Keep your Secret Key secure and do not share it publicly. This key provides full access to your Stripe account.
Connect your Stripe account to TRUE to enable payment processing.
- Click the Gear icon and select Company Preferences
- Navigate to the Integrations section
- Select Stripe
- Paste the copied Secret Key from Stripe into the appropriate field
- Configure additional settings as needed
- Click Save
Configure the BBPOS WisePOS E card reader for in-person payments.
- Turn on the BBPOS WisePOS E Card Reader
- Connect the reader to your network
- Copy the registration code displayed on the reader
- Open your Stripe Dashboard and navigate to Payments > Readers
- Click New to add a new reader
- Enter the Location information and save
- Select the new Location and click New under the Readers section
- Enter the Registration code from the card reader and save
Note: TRUE's Stripe integration supports the BBPOS WisePOS E reader. The device must be purchased using the Stripe.com account linked to your TRUE instance.
Configure additional Stripe integration settings in Company Preferences.
| Setting | Description |
|---|---|
| Secret Key | The Stripe API secret key used to authenticate and authorize transactions |
| Registration Code | Unique code used to link the BBPOS WisePOS E reader to the Stripe account |
| Automatic Credit Card Fees | Enable automated credit card fee application for Stripe transactions |
| Minimum Transaction Amount | Minimum amount required to trigger the automatic transaction fee |
| Credit Card Fee | Automatic credit card fee percentage applied to Point of Sale transactions |
Frequently Asked Questions
Common questions about using Stripe integration with TRUE
Setup & Configuration
Stripe test mode allows you to verify your integration works correctly before processing live payments.
- Navigate to Company Preferences > Integrations > Stripe
- Check the Enable Stripe Test mode checkbox
- Enter your Stripe test API key (found in Stripe Dashboard under test mode)
- Process test transactions using Stripe's test card numbers
- When ready to go live, uncheck test mode and enter your live API key
Tip: Always test your integration thoroughly before switching to live mode. Use Stripe's test card numbers (like 4242 4242 4242 4242) for testing.
After creating your Stripe account, complete these steps to start accepting payments:
- Complete Stripe's identity verification process
- Link your bank account for payouts
- Obtain your Live API Secret Key from Developers > API Keys
- Configure the integration in TRUE Company Preferences
- Process a test transaction to verify the setup
Payment Processing
Transaction limits depend on your Stripe account status and the card type being used.
- New Stripe accounts may have initial transaction limits that increase over time
- American Express cards may have different limits than Visa/Mastercard
- High-value transactions may require additional verification from the card issuer
- Contact Stripe directly to request limit increases for your account
Note: If a large transaction fails, have the customer contact their card issuer to verify no blocks are in place on their account.
Yes, you can store multiple payment methods for customers. When taking a payment, click Add Card to add additional cards to the customer's payment options.
Tip: If you see "click to add card" appearing multiple times, try backing out and starting the payment process again. This can occur if a previous card was declined.
If a payment appears in your Stripe dashboard but isn't reflected in TRUE, try these steps:
- Refresh the TRUE window
- Navigate away from the record and back to it
- Check the invoice record to see if payment is applied
- Verify the correct customer/invoice was selected when processing
- Review the Stripe dashboard to confirm the charge was successful
If the payment still doesn't appear, contact TRUE Support with the transaction details from your Stripe dashboard.
Troubleshooting
Card declines can occur for various reasons. Here's how to handle them:
- Insufficient Funds: Customer needs to use a different payment method
- Incorrect Card Details: Verify card number, expiration date, and CVV
- Card Issuer Block: Customer should contact their bank to authorize the transaction
- High Amount: Large transactions may trigger fraud protection
- Try Another Card: Have customer provide an alternate payment method
If you used demo data or test mode before switching to live keys, you may encounter errors because test and live data don't mix.
- Ensure you're using your live Secret Key (not test key)
- Verify the Enable Stripe Test mode checkbox is unchecked
- Clear any saved test payment methods from customer records
- Add new payment methods using real card information
Note: Test transactions and live transactions use separate API keys. Data created in test mode cannot be accessed in live mode.
Stripe may send security notifications for various reasons. If you only process payments through TRUE and haven't shared your account access:
- Review the email carefully to understand what triggered the notification
- Log into your Stripe dashboard to verify your account status
- Check for any unfamiliar activity in your transaction history
- Update your API key if Stripe indicates it may be compromised
- Contact Stripe support directly for security-related concerns
Warning: Never share your Stripe Secret Key with anyone. If you believe your key has been compromised, rotate it immediately in your Stripe dashboard.