Integrating Spacebring with the Stripe gateway allows you to seamlessly accept payments for all products and services. When a user makes a booking or purchase and completes a payment, Stripe handles the transaction, and Spacebring updates the payment status accordingly. However, transaction success can be influenced by several factors, including the performance of the Stripe payment gateway, the user's bank, etc.
If the transaction has been unsuccessful, you cannot find a specific payment, or need to understand the reason for a payment failure, follow these steps.
To troubleshoot payments, you need administrator access to the Spacebring location where the payment has been initiated and access to your Stripe dashboard.
1. Check the transaction status in Spacebring
When the payment doesn't go through, it's essential to understand the reason for this to assist your customer. Spacebring reflects clear statuses for each transaction, helping you identify the next steps.
To see the payment status:
Go to the Customers page > "Members" or "Nonmembers" tab, depending on the customer's role.
Open the user or company profile > Billing > Transactions.
You will see one of the following statuses for each transaction:
Transaction status | Description | Your actions |
Paid | The payment has been successfully completed. | You can verify it in Stripe using the receipt number. |
Failed | The payment was declined by Stripe or the customer's bank for some reason, e.g. insufficient balance or card restrictions like "Your card does not support this type of purchase." |
|
Canceled | The user initiated the payment but closed the payment page without completing the transaction. | Ask your user to complete the payment. |
Pending | The user has opened the payment page but still needs to complete the payment. If 15 minutes expire and the user doesn't complete it, this transaction status will automatically change to "Canceled". | Ask your user to complete the payment. |
Processing | The payment attempt has been completed by the user, and Spacebring is awaiting payment confirmation from Stripe. | Wait for the transaction to be processed and check its status then. |
Disputed | The user disputed the payment with their bank.
The "Transactions" report will show the transaction status as "Paid," and the disputed amount will be reflected in the "Amount Disputed" column. |
2. Check the transaction details in Stripe dashboard
If the payment has a "Failed" or "Processing" status in Spacebring, or if you need more details about the error message or failure reason, your Stripe dashboard is the next place to look.
For example, errors such as "Your card does not support this type of purchase" often indicate restrictions set by the card issuer and require specific troubleshooting steps.
For this:
Go to the customer's profile in Spacebring > Billing > click the
Stripe customerbutton on the right-hand panel.This will directly open the customer's transaction history page within your Stripe dashboard, where you can then locate and check the relevant transaction.
Alternatively:
Navigate to the Analytics page > tap
Create reportat the top right corner > create a report with "Transactions" type and download the report.By checking the amount, time, or status of the transaction, find the one you're looking for and copy its ID from the "ID" column.
Go to your Stripe dashboard and use the copied transaction ID to find the specific payment and reveal more details about it.
In Spacebring, the transaction ID serves as the distinct identifier for the transaction. Always use this ID to search for transactions in Stripe, as user names or emails can sometimes be changed, making them unreliable search criteria.
3. Reach out to the Stripe team for help
If the previous steps have not clarified the payment issue, or if you encounter an error message from Stripe that you don't understand, it's time to contact Stripe support. Provide them with the transaction ID and ask for further assistance or clarification of the error message.