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 the Stripe dashboard
If a payment has a status of “Failed,” “Processing,” or “Disputed,” or if you need more information about the error or failure reason, the next step is to check your Stripe dashboard. To do this:
Open the specific transaction in Spacebring.
Click
View in Stripe
.
This will take you directly to this transaction’s page in your Stripe dashboard, where you can access detailed information about the payment status, error messages, and failure reasons.
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.
Alternatively:
Navigate to the Analytics page > tap
Create report
at 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.