Docs Home
Dev Essentials
PaymentsCommerceCustomersStaffMerchants
Publish
Release notes

Docs

Docs Home
Dev Essentials
Payments
Commerce
Customers
Staff
Merchants
Publish
Release notes
Overview
Build a Tip Report
Split an Online Payment
Build a Sales Report
Delayed Capture
Partial Payments
Statement Descriptions
ACH Bank Transfer Payment
Afterpay and Clearpay Payments
Cash App Payments
Cash Payments
External Payments
House Accounts
Collect Application Fees
Update Payment and Tip Amounts
Retrieve Payments
Troubleshoot
Webhooks
Refund Payments
Refund a Payment with an App Fee
Retrieve Refunds
Webhooks
Process Disputes
Test in the Sandbox
POS Integration
Connect a Square Terminal
Take Payments
Dismiss Terminal Checkouts and Refunds
Terminal Device Monitoring
Save Card on File
Check Device Information
Print or Issue Receipts
Customize the Idle Screen
Confirmation Screen
Signature Capture Screen
Data Collection Screen
Menu Selection List Screen
QR Code Screen
Link and Dismiss Actions
Refund Interac Payments
E-Money Payments
PayPay QR Code Payments
Get Credentials
Configure the Sample Application
Take a Cash Payment
Customize the Checkout Amount
Take a Credit Card Payment
How It Works
Build on Android
Build on iOS
Connect a Contactless Reader
Charge a Card on File
Save a Card on File
Configure on iOS for Square Stand
Deauthorize Reader SDK
Capture a Transaction
Delay the Capture of Payments
Configure APK Splits
Update to New Reader SDK Version
Flutter Plugin
React Native Plugin
How It Works
Build on Android
Build on iOS
Build on Mobile Web
Find Your Android Fingerprint
Use the API in Offline Mode
Add an Alert Dialog Helper Class
Accept E-Money Payments
Accept PayPay Payments
Mobile Web Technical Reference
Payments API Integration
Take Payments Online
Take a Card Payment
Apple Pay
Google Pay
Payment Requests
ACH Bank Transfer
Afterpay
Cash App Pay
Gift Cards Overview
Take a Gift Card Payment
Walkthrough: Partial Payments with Gift Cards
Customize the Card Entry Form
Verify the Buyer
Store Card on File with SCA
Charge Card on File with SCA
In-App Payments SDK
Set up the Client
Deploy the Server
Install the SDK
Build on Android
Build on iOS
Apple Pay
Google Pay
Enable SRC for Android
Enable SRC for iOS
Localize an Application
Gift Card Payments
Flutter Plugin
React Native Plugin
Customize the Payment Entry Form
Connect to a Backend Service
Remove the Postal Code Requirement
Troubleshoot
How It Works
Verify Buyer
Quick Pay Checkout
Square Order Checkout
Subscription Plan Checkout
Checkout Settings
Checkout Configurations
Manage Checkout
Guidelines and Limitations
Create and Publish Invoices
Retrieve, List, or Search Invoices
Create or Delete Invoice Attachments
Update Invoices
Cancel or Delete Invoices
Pay or Refund Invoices
Invoices Walkthrough
Subscription Plans and Variations
Manage Subscriptions
Subscription Actions and Events
Pause, Resume, or Cancel Subscriptions
Subscription Billing and Invoices
Swap Subscription Plan Variations
Manage Cards
Create a Card on File from Payment ID
Create a Card on File and a Payment
Create a Shared Card on File and Make a Payment
List Payouts
Get Payout
List Payout Entries
Bank Accounts
How It Works
Build with Mobile Authorization
Get Authorization Code on Command Line
Payment Methods by Country
Payments Pricing
Strong Customer Authentication
Payment Minimums

/

Payments

/

Take Payments Online

/

In-App Payments SDK

Troubleshoot In-App Payments SDK Problems

Troubleshoot problems with the In-App Payments SDK.

Link to section

I get an apple_pay_nonce_request_invalid_certificate when requesting a payment token

Cause:

There's a problem with your Apple Pay payment processing certificate or Xcode has cached an older (invalid) certificate.

Solution:

  1. Ensure that your Apple Pay certificate in the Apple Developer Portal is active.
  2. Verify that you've uploaded the certificate to the Developer Dashboard.

If you continue receiving the error, you might need to clear a cached certificate:

  1. Create a new Square CSR for Apple Pay using the Square Developer Dashboard.
  2. Sign in to the Apple Developer Portal and follow the steps in Create a merchant identifier to create a new merchant ID.
  3. In the Apple Developer Portal, create a new Apple Pay payment processing certificate for your new merchant ID by uploading the new Square CSR.
  4. Upload the new Apple Pay certificate to the Developer Dashboard.
  5. Update your Apple Pay merchant ID on the Capabilities tab in Xcode.
  6. Update the code that creates your PKPaymentRequest to use the new merchant ID.