Payment Failure Troubleshooting Guide
Payment failures frustrate customers and result in lost sales. When a customer's payment does not process successfully, they may abandon their purchase or lose confidence in the platform. This SOP provides systematic troubleshooting procedures to help customers resolve payment issues and complete their purchases.
Understanding Payment Failure Types
Payment failures occur for various reasons, and identifying the type of failure helps determine the appropriate resolution path.
Common Payment Failure Categories
| Failure Type | Typical Causes | Customer Message |
|---|---|---|
| Card Declined | Insufficient funds, card limits, bank block | Payment declined by issuing bank |
| Authentication Failed | 3D Secure failure, OTP issues | Unable to verify payment |
| Technical Error | System timeout, connectivity issues | Payment could not be processed |
| Invalid Card Details | Wrong number, expired card | Card information invalid |
| Fraud Prevention | Triggered security rules | Transaction cannot be completed |
| Payment Method Unavailable | Maintenance, regional restrictions | Payment method temporarily unavailable |
Initial Troubleshooting Steps
When a customer reports a payment failure, begin with these universal troubleshooting steps before diving into specific issues.
Gather Essential Information
Collect the following details to understand the situation:
- Payment method attempted such as credit card, debit card, wallet, or bank transfer
- Error message displayed if any
- When the failure occurred including date and time
- Whether this is a first-time failure or recurring issue
- Order total and any vouchers applied
- Device and browser or app used for checkout
Verify Order Status
Before troubleshooting further, check the order status in the system. Sometimes payments process successfully despite error messages shown to customers. Verify whether an order was created, if payment was captured, and the current order status. If the order exists and payment was successful, the customer simply needs reassurance and order confirmation.
Card Payment Failures
Credit and debit card payments are the most common payment method and the most frequent source of payment issues.
Card Declined Troubleshooting
When a card is declined, guide customers through these checks:
- Verify sufficient available balance or credit limit for the purchase amount
- Check if the card has reached daily or transaction limits
- Confirm the card is activated for online or international transactions
- Ensure the card has not expired
- Verify billing address matches what the bank has on file
If all customer-side factors check out, the decline may be from the bank's fraud prevention system. Advise the customer to contact their bank to authorize the transaction or whitelist Niceazda as a trusted merchant.
3D Secure Authentication Issues
Many card payments require 3D Secure verification through a one-time password or app approval. Common issues include:
- OTP not received due to phone or email delivery issues
- OTP expired before entry as codes typically valid for only a few minutes
- Customer closed the authentication window prematurely
- Bank app not installed or configured for authentication
- Pop-up blockers preventing authentication window from appearing
Guide customers to ensure their registered mobile number with the bank is current, disable pop-up blockers temporarily, complete authentication quickly before timeout, and use the bank's mobile app if available instead of SMS.
Invalid Card Details Errors
Have the customer verify their entered information carefully:
- Card number entered correctly without extra spaces
- Expiry date in correct format as month and year
- CVV or CVC code matches the card
- Cardholder name matches the card exactly
Suggest the customer remove the saved card and re-enter details fresh if they continue experiencing issues with saved card information.
Digital Wallet Payment Issues
Niceazda Wallet and partner digital wallet payments have their own troubleshooting considerations.
Niceazda Wallet Failures
When Niceazda Wallet payments fail, check the wallet balance is sufficient for the order total including shipping, the wallet account is verified if required for the transaction amount, and there are no holds or restrictions on the wallet account. If balance is insufficient, guide the customer to top up their wallet or use a different payment method for the difference if split payment is available.
Partner Wallet Integration Issues
For payments through partner digital wallets, verify the customer is logged into the partner wallet app, the partner wallet account is verified and active, sufficient balance exists in the partner wallet, and the integration between apps is working correctly. If partner wallet payments consistently fail, check the system status for any known integration issues with that payment provider.
Bank Transfer and Other Methods
Bank transfers and alternative payment methods have unique troubleshooting requirements.
Bank Transfer Payment Pending
Bank transfer payments may show as pending while awaiting confirmation. Explain the typical processing time of one to three business days, advise the customer to complete the transfer using the exact reference number provided, verify the correct receiving bank account was used, and confirm the exact amount was transferred without deductions. If the payment does not confirm within the expected timeframe, the customer should provide their bank transfer receipt for manual verification.
Cash on Delivery Eligibility
If customers are attempting COD but the option is not available, check whether their delivery location is within COD coverage, the order total is within COD limits, the product category supports COD, and the customer account is eligible for COD. Explain any restrictions that apply and suggest alternative payment methods.
Technical Error Resolution
Technical errors may be caused by issues on the customer's device, network, or our systems.
Customer-Side Technical Fixes
Recommend customers try these steps for technical payment errors:
- Clear browser cache and cookies then retry
- Try a different browser or use the mobile app
- Disable browser extensions that might interfere
- Switch between WiFi and mobile data
- Update the app to the latest version
- Restart the device and try again
System-Side Issues
If multiple customers report similar payment failures, check for known system issues or maintenance affecting payment processing. Inform affected customers of estimated resolution time and offer alternatives such as COD or trying again later. Document and report any patterns suggesting system problems to the technical team.
Fraud Prevention Blocks
Some payment failures result from fraud prevention systems detecting unusual activity.
Recognizing Fraud Prevention Blocks
Indicators that a payment was blocked by fraud prevention include generic decline message without specific reason, account flagged for review, unusual purchasing pattern detected, and new account with high-value order. If you suspect fraud prevention is blocking a legitimate customer, do not override security controls. Escalate to the Risk team for review with relevant details about the customer and transaction.
Advising Customers
When fraud prevention appears to be the cause, explain that security systems may require additional verification for certain transactions. Suggest the customer try a smaller test transaction first, use a verified payment method or account, contact their bank if they believe their card is being blocked, or wait 24 hours if their account was flagged for review.
Escalation and Follow-Up
Some payment issues cannot be resolved through standard troubleshooting and require escalation.
When to Escalate
- Payment deducted from customer but order not created
- Duplicate charges on customer's account
- System-wide payment processing issues
- Suspected fraud or security concerns
- Complex disputes requiring payment team investigation
Provide the customer with a case reference number and realistic timeline for resolution. Payment-related escalations typically require 24 to 72 hours for investigation.
Documentation
Document all payment failure cases with the specific error encountered, troubleshooting steps attempted, and resolution or escalation outcome. This information helps identify patterns, improve troubleshooting guides, and supports case resolution if customers follow up.
