“Something went wrong: Please contact the developer of this application and provide them with this error code: checkout_microphone_permission_denied”
I can find no documentation on this error. I have confirmed that microphone permissions are enabled for the app on the device experiencing the issue.
Can someone provide a clear answer on why this error occurs?
I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:
Guidelines and Limitations
Take a Cash Payment
Build with the Mobile Authorization API
If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.
Not a valid solution.
The error code “checkout_microphone_permission_denied” indicates that the application doesn’t have the necessary permissions to access the microphone on the device. This is required for the Square Reader SDK to process card payments using the magstripe reader, which connects via the headphone jack and uses the microphone input for data transfer.
Even though you’ve confirmed that microphone permissions are enabled for the app on the device, the error suggests that the app is still not able to access the microphone. This could be due to various reasons such as other apps using the microphone at the same time, or device-specific restrictions.
You should ensure that no other apps are using the microphone when a payment is being processed. Also, check if there are any additional settings on the device that could be preventing the app from accessing the microphone. If the issue persists, you might need to debug the app on the device to get more detailed information about the error.
This answer was reviewed by @Bryan-Square.
So this doesn’t really narrow anything down. Can you not offer any troubleshooting advice on this? I can’t tell my users to check if they have other apps that use the microphone at the same time. This cannot be a realistic expectation for a developer to troubleshoot.
If it helps, this is for iOS exclusively.
Are you giving permission? This permission is a requirement. 
Yes. Were giving microphone permission to our app. I received a screenshot confirming that.
What troubleshooting have they done? If they delete and re-install the app does it work? Also is this with iOS or Android?
This is exclusively iOS. And they have tried deleting and reinstalling the app. This isn’t affecting all users. Just a select, primarily new set of users. Previous users have reported it only for the issue to go away of its own accord after a few weeks.
Do you have any updates on this? Users are saying they can pair the reader via iOS bluetooth screen. But cannot pair the device via the Square Reader SDK screen. It simply stalls with no result.
I’m also seeing that there’s uptime issues with the Square POS API? Are these related?
Are they using iOS 18.4? If so Reader SDK won’t work on iOS 18.4.
Let me guess: Square has no intent of patching this issue.
By the way, we figured out the fix. And it had nothing to do with the error message. You had to download Square POS, pair it via a device code. Then repair the card reader with our custom POS before it worked…
None of this is documented. Is there no one working on documentation anymore?
At this time there is no other fix but to update to Mobile Payments SDK 2.2.1.
Are you saying that downloading the Square POS and pairing in that app and then going to your custom app and pairing it worked?
That’s correct this isn’t a documented and supported workaround.