# \#cards-api **URL:** https://developer.squareup.com/forums/tag/cards-api/54.md [Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md) --- ## [Japan: recurring card-on-file payments using our own scheduler — MIT/3DS and API requirements](https://developer.squareup.com/forums/t/japan-recurring-card-on-file-payments-using-our-own-scheduler-mit-3ds-and-api-requirements/28381)
**Author:** [@uedadaiki](https://developer.squareup.com/forums/u/uedadaiki)\ **Replies:** 2\ **Last updated:** [November 2, 2026, 7:39pm UTC](https://developer.squareup.com/forums/t/japan-recurring-card-on-file-payments-using-our-own-scheduler-mit-3ds-and-api-requirements/28381 "2026-11-02T19:39:37Z")
Hello Square Developer Support, We are integrating Square into a subscription-based web service in Japan. Square Japan Support referred us to this forum for technical guidance. First, we would like to clarify our inten… --- ## [PCI DSS Level 1 - send network tokens and raw pans](https://developer.squareup.com/forums/t/pci-dss-level-1-send-network-tokens-and-raw-pans/28407)
**Author:** [@palbrecht](https://developer.squareup.com/forums/u/palbrecht)\ **Replies:** 1\ **Last updated:** [November 2, 2026, 5:32pm UTC](https://developer.squareup.com/forums/t/pci-dss-level-1-send-network-tokens-and-raw-pans/28407 "2026-11-02T17:32:51Z")
Hi, we’re a global payment orchestrator with \> 4bn$/year in volume, we’d like to integrate with Square’s direct payment API, where we could send out raw PANs, network tokens, auth codes, and decrypted Apple Pay / Google … --- ## [Payments API policy and authorization requirements](https://developer.squareup.com/forums/t/payments-api-policy-and-authorization-requirements/28255)
**Author:** [@Donna-SweetServ](https://developer.squareup.com/forums/u/Donna-SweetServ)\ **Replies:** 3\ **Last updated:** [October 28, 2026, 4:09pm UTC](https://developer.squareup.com/forums/t/payments-api-policy-and-authorization-requirements/28255 "2026-10-28T16:09:08Z")
Hello Square Developer Support, Where can developers find the current US requirements for permitted use cases, saved-card authorization, seller-initiated payments, customer notices and record retention? We also need a … --- ## [Square Customer Merge: Impact on Cards API IDs and CreatePayment](https://developer.squareup.com/forums/t/square-customer-merge-impact-on-cards-api-ids-and-createpayment/28327)
**Author:** [@nrizzo10](https://developer.squareup.com/forums/u/nrizzo10)\ **Replies:** 1\ **Last updated:** [October 26, 2026, 9:08am UTC](https://developer.squareup.com/forums/t/square-customer-merge-impact-on-cards-api-ids-and-createpayment/28327 "2026-10-26T09:08:44Z")
We store Square customer IDs and card-on-file IDs (Cards API) and charge with CreatePayment using source\_id = card ID and customer\_id = our stored customer ID. Your “Duplicate customer profiles” page says a merged custo… --- ## [CreateCard INVALID\_CARD\_DATA after successful Web Payments SDK tokenization — request for private trace review](https://developer.squareup.com/forums/t/createcard-invalid-card-data-after-successful-web-payments-sdk-tokenization-request-for-private-trace-review/28292)
**Author:** [@PKLCTY](https://developer.squareup.com/forums/u/PKLCTY)\ **Replies:** 1\ **Last updated:** [October 22, 2026, 6:40pm UTC](https://developer.squareup.com/forums/t/createcard-invalid-card-data-after-successful-web-payments-sdk-tokenization-request-for-private-trace-review/28292 "2026-10-22T18:40:18Z")
We need help identifying the cause of a production card-on-file verification failure. A customer successfully generated a card token through the Web Payments SDK, but POST /v2/cards returned HTTP 400: category: INVALID\_… --- ## [API endpoint for card balances](https://developer.squareup.com/forums/t/api-endpoint-for-card-balances/28097)
**Author:** [@TheWizard1328](https://developer.squareup.com/forums/u/TheWizard1328)\ **Replies:** 1\ **Last updated:** [October 5, 2026, 2:46pm UTC](https://developer.squareup.com/forums/t/api-endpoint-for-card-balances/28097 "2026-10-05T14:46:27Z")
is there any chance of there being an API endpoint to get a card/location balance. I am running a web/android delivery platform and it would be nice to be able ping the balances of each of my cards for my stores instead… --- ## [CreateInvoice returns INVALID\_CARD for a card created seconds earlier with CreateCard](https://developer.squareup.com/forums/t/createinvoice-returns-invalid-card-for-a-card-created-seconds-earlier-with-createcard/28049)
**Author:** [@raycionic](https://developer.squareup.com/forums/u/raycionic)\ **Replies:** 1\ **Last updated:** [October 5, 2026, 1:48pm UTC](https://developer.squareup.com/forums/t/createinvoice-returns-invalid-card-for-a-card-created-seconds-earlier-with-createcard/28049 "2026-10-05T13:48:41Z")
We’re seeing intermittent INVALID\_CARD errors from CreateInvoice in production, and we’d like to understand what causes them and how to avoid them. Our flow (Web Payments SDK, then server-side calls) The browser calls… --- ## [CreateCard INVALID\_CARD\_DATA with Ecuador-issued international Visa after successful payment](https://developer.squareup.com/forums/t/createcard-invalid-card-data-with-ecuador-issued-international-visa-after-successful-payment/27890)
**Author:** [@fcedeno](https://developer.squareup.com/forums/u/fcedeno)\ **Replies:** 14\ **Last updated:** [September 29, 2026, 7:31pm UTC](https://developer.squareup.com/forums/t/createcard-invalid-card-data-with-ecuador-issued-international-visa-after-successful-payment/27890 "2026-09-29T19:31:31Z")
Hello Square Developer Team, I’m experiencing a consistent issue specifically when trying to save an international Visa credit card issued in Ecuador as a Card on File. The important point is that Square successfully p… --- ## [Is the Card fingerprint consistent across sellers who authorise the same OAuth app?](https://developer.squareup.com/forums/t/is-the-card-fingerprint-consistent-across-sellers-who-authorise-the-same-oauth-app/28022)
**Author:** [@efacts\_founders](https://developer.squareup.com/forums/u/efacts_founders)\ **Replies:** 2\ **Last updated:** [September 29, 2026, 3:57pm UTC](https://developer.squareup.com/forums/t/is-the-card-fingerprint-consistent-across-sellers-who-authorise-the-same-oauth-app/28022 "2026-09-29T15:57:08Z")
Hi Square team, I’m building E-Facts (efacts.ca), a Canadian digital receipts app that sellers will connect through OAuth. We read Payments and Orders data to generate digital receipts for shoppers. I have a few questio… --- ## [Need urgent help with 400 response INVALID\_REQUEST\_ERROR](https://developer.squareup.com/forums/t/need-urgent-help-with-400-response-invalid-request-error/17632)
**Author:** [@swapnil.chavan18](https://developer.squareup.com/forums/u/swapnil.chavan18)\ **Replies:** 10\ **Last updated:** [September 18, 2026, 2:28pm UTC](https://developer.squareup.com/forums/t/need-urgent-help-with-400-response-invalid-request-error/17632 "2026-09-18T14:28:36Z")
category": "INVALID\_REQUEST\_ERROR", "code": "INVALID\_CARD\_DATA", "detail": "Invalid card data.", "field": "source\_id" Please let us know what is the reason for this and how to solve this? --- ## [Unable to add customer card - INVALID\_REQUEST\_ERROR / INVALID\_CARD\_DATA / source\_id](https://developer.squareup.com/forums/t/unable-to-add-customer-card-invalid-request-error-invalid-card-data-source-id/11595)
**Author:** [@DeanPP](https://developer.squareup.com/forums/u/DeanPP)\ **Replies:** 8\ **Last updated:** [September 18, 2026, 4:27am UTC](https://developer.squareup.com/forums/t/unable-to-add-customer-card-invalid-request-error-invalid-card-data-source-id/11595 "2026-09-18T04:27:32Z")
We are seeing issues with card creation (POST /v2/cards) using the web SDK (version 2023-10-20). The following error is being reported: Invalid card data (source\_id). We are successfully storing cards (350+ in the past… --- ## [INVALID\_CARD\_DATA problem](https://developer.squareup.com/forums/t/invalid-card-data-problem/5245)
**Author:** [@dejital1](https://developer.squareup.com/forums/u/dejital1)\ **Replies:** 10\ **Last updated:** [September 8, 2026, 6:55pm UTC](https://developer.squareup.com/forums/t/invalid-card-data-problem/5245 "2026-09-08T18:55:59Z")
I have a client that is integrated into our platform through oath. When they try to add a card through our integration they are getting this INVALID\_CARD\_DATA error below. It only seems to be affecting them and no other… --- ## [Can square\_card\_id from a third-party card import mapping file be used as card\_id in CreateSubscription?](https://developer.squareup.com/forums/t/can-square-card-id-from-a-third-party-card-import-mapping-file-be-used-as-card-id-in-createsubscription/26811)
**Author:** [@jiyu](https://developer.squareup.com/forums/u/jiyu)\ **Replies:** 1\ **Last updated:** [July 24, 2026, 5:35pm UTC](https://developer.squareup.com/forums/t/can-square-card-id-from-a-third-party-card-import-mapping-file-be-used-as-card-id-in-createsubscription/26811 "2026-07-24T17:35:44Z")
Hi, We are planning to migrate existing subscribers from Stripe to Square. Square Support in Japan confirmed the following: Third-party card data can be imported from Stripe to Square. After the card import, the sell… --- ## [Integration of Square with Third-Party Platform](https://developer.squareup.com/forums/t/integration-of-square-with-third-party-platform/26105)
**Author:** [@grace](https://developer.squareup.com/forums/u/grace)\ **Replies:** 1\ **Last updated:** [May 18, 2026, 1:27pm UTC](https://developer.squareup.com/forums/t/integration-of-square-with-third-party-platform/26105 "2026-05-18T13:27:27Z")
Hello Square Developer Team, I am currently building an integration where a third-party system handles order creation and payment processing (outside of Square), and I want to sync those orders into Square for reporting … --- ## [\[sandbox\] inconsistent support of emails like test@example.com](https://developer.squareup.com/forums/t/sandbox-inconsistent-support-of-emails-like-test-example-com/25316)
**Author:** [@nymkappamempoolspace](https://developer.squareup.com/forums/u/nymkappamempoolspace)\ **Replies:** 1\ **Last updated:** [February 9, 2026, 7:52pm UTC](https://developer.squareup.com/forums/t/sandbox-inconsistent-support-of-emails-like-test-example-com/25316 "2026-02-09T19:52:25Z")
Hi, My OP was asking about possibly a broken sandbox credit card support on your end but I remembered that I had the same issue a while ago (see https://developer.squareup.com/forums/t/sandbox-card-4111-1111-1111-1111-d… --- ## [Invalid\_request\_error](https://developer.squareup.com/forums/t/invalid-request-error/25243)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 10\ **Last updated:** [February 4, 2026, 6:18pm UTC](https://developer.squareup.com/forums/t/invalid-request-error/25243 "2026-02-04T18:18:31Z")
I have had a problem with impatient users pressing the submit button to create a payment – pressing multiple times while waiting for a ‘success’ message, and thereby creating multiple payments. I have been adding code t… --- ## [Customer Not Found Weirdness](https://developer.squareup.com/forums/t/customer-not-found-weirdness/24508)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 8\ **Last updated:** [November 15, 2025, 11:53pm UTC](https://developer.squareup.com/forums/t/customer-not-found-weirdness/24508 "2025-11-15T23:53:59Z")
In my database I use the customer API to create and save the squareid for every ‘customer’ associated with the business. Most are actual paying customers, some are potential customers I create based on email, etc. I use… --- ## [Save ACH data for later use](https://developer.squareup.com/forums/t/save-ach-data-for-later-use/8279)
**Author:** [@RimMahmoud](https://developer.squareup.com/forums/u/RimMahmoud)\ **Replies:** 3\ **Last updated:** [November 12, 2025, 2:16am UTC](https://developer.squareup.com/forums/t/save-ach-data-for-later-use/8279 "2025-11-12T02:16:13Z")
I’m implementing ACH and card payments into a website. I’m saving the card info of the customer for later payments and it’s working perfectly. But using ACH how can I save the customer’s info in order to let him make la… --- ## [Why is Saved Card( MasterCard ) saved using ApplePay tap failing when used later?](https://developer.squareup.com/forums/t/why-is-saved-card-mastercard-saved-using-applepay-tap-failing-when-used-later/23720)
**Author:** [@maheshn\_spry](https://developer.squareup.com/forums/u/maheshn_spry)\ **Replies:** 2\ **Last updated:** [August 19, 2025, 4:06pm UTC](https://developer.squareup.com/forums/t/why-is-saved-card-mastercard-saved-using-applepay-tap-failing-when-used-later/23720 "2025-08-19T16:06:50Z")
We couldn’t use a CardOnFile that is saved when paid using ApplePay and the Create Card API worked and we were able to tokenize the card but the payment with this saved card is failing. Network type is mastercard --- ## [Payment ID as card source - 'source has expired'](https://developer.squareup.com/forums/t/payment-id-as-card-source-source-has-expired/23403)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 2\ **Last updated:** [July 28, 2025, 8:06pm UTC](https://developer.squareup.com/forums/t/payment-id-as-card-source-source-has-expired/23403 "2025-07-28T20:06:20Z")
Tried to create a card using a payment\_id as a source. Errow said ‘source had expired’ – NO PROBLEM – payment was several days old and I trying to do this manually. BUT how long before a payment id expires? --- ## [Sandbox card 4111 1111 1111 1111 does not work anymore](https://developer.squareup.com/forums/t/sandbox-card-4111-1111-1111-1111-does-not-work-anymore/23018)
**Author:** [@nymkappamempoolspace](https://developer.squareup.com/forums/u/nymkappamempoolspace)\ **Replies:** 2\ **Last updated:** [July 2, 2025, 12:26pm UTC](https://developer.squareup.com/forums/t/sandbox-card-4111-1111-1111-1111-does-not-work-anymore/23018 "2025-07-02T12:26:40Z")
Good day, I tried creating a new subscription ed8cdc07-8c23-45b9-ac5b-097096d17fdc using the sandbox card 4111 1111 1111 1111, the subscription immediately goes into DEACTIVATED state without issuing any invoice. I trie… --- ## [Cards point to old customer after merge](https://developer.squareup.com/forums/t/cards-point-to-old-customer-after-merge/22586)
**Author:** [@wjps](https://developer.squareup.com/forums/u/wjps)\ **Replies:** 6\ **Last updated:** [June 11, 2025, 7:31am UTC](https://developer.squareup.com/forums/t/cards-point-to-old-customer-after-merge/22586 "2025-06-11T07:31:58Z")
There seems to be some weirdness around the ways cards are handled in the API. After merging customers it seems like the customer\_id in the Card object is not updated and so points to a non-existent customer. However wh… --- ## [Random "Payment on file not found" errors](https://developer.squareup.com/forums/t/random-payment-on-file-not-found-errors/9106)
**Author:** [@onajartm](https://developer.squareup.com/forums/u/onajartm)\ **Replies:** 6\ **Last updated:** [June 6, 2025, 1:02pm UTC](https://developer.squareup.com/forums/t/random-payment-on-file-not-found-errors/9106 "2025-06-06T13:02:07Z")
We have a payment flow that involves saving a card on file via Reader SDK and charging it some time later. Occasionally we see some “Payment on file not found” errors and I’m not sure why. Upon further inspection in Squ… --- ## [Question: card.automatically\_updated webhook](https://developer.squareup.com/forums/t/question-card-automatically-updated-webhook/22068)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 6\ **Last updated:** [April 24, 2025, 9:41pm UTC](https://developer.squareup.com/forums/t/question-card-automatically-updated-webhook/22068 "2025-04-24T21:41:03Z")
Got a card.created webhook. Literally 10 seconds later got this webhook. \[type\] =\> card.automatically\_updated \[event\_id\] =\> d612387a-8dc0-3ffc-bc8d-1ebe7ce18cab \[created\_at\] =\> 2025-04-23T21:30:29.810249296Z Only di… --- ## [Cards API no longer returning card type or brand](https://developer.squareup.com/forums/t/cards-api-no-longer-returning-card-type-or-brand/21773)
**Author:** [@raycionic](https://developer.squareup.com/forums/u/raycionic)\ **Replies:** 3\ **Last updated:** [April 4, 2025, 7:44pm UTC](https://developer.squareup.com/forums/t/cards-api-no-longer-returning-card-type-or-brand/21773 "2025-04-04T19:44:06Z")
Today, I started seeing tracebacks in my code because the retrieve card API stopped including the card type and brand in the response. I still get a 200 response for the card id. It just doesn’t include the card type or… --- ## [Card API "Source was used before"](https://developer.squareup.com/forums/t/card-api-source-was-used-before/21061)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 9\ **Last updated:** [February 18, 2025, 5:04pm UTC](https://developer.squareup.com/forums/t/card-api-source-was-used-before/21061 "2025-02-18T17:04:21Z")
I am using the Cards SDK, and I have wrapped the results in my own PHP, including a wrapper around the SDK interface. I discoved user problems in the real world, and began some intensive testing. The problem involves a… --- ## [POST /v2/cards completely ignores \`card.billingAddress.firstName\` and \`lastName\`](https://developer.squareup.com/forums/t/post-v2-cards-completely-ignores-card-billingaddress-firstname-and-lastname/20692)
**Author:** [@nymkappamempoolspace](https://developer.squareup.com/forums/u/nymkappamempoolspace)\ **Replies:** 2\ **Last updated:** [January 21, 2025, 6:44pm UTC](https://developer.squareup.com/forums/t/post-v2-cards-completely-ignores-card-billingaddress-firstname-and-lastname/20692 "2025-01-21T18:44:59Z")
Hi, While testing https://developer.squareup.com/explorer/square/cards-api/create-card API, I’ve noticed that the firstName and lastName field are completely ignored when creating a new card on file. I want to rely on … --- ## [Can the card fingerprint be determined before a payment?](https://developer.squareup.com/forums/t/can-the-card-fingerprint-be-determined-before-a-payment/20188)
**Author:** [@mmaccou](https://developer.squareup.com/forums/u/mmaccou)\ **Replies:** 14\ **Last updated:** [December 20, 2024, 11:52pm UTC](https://developer.squareup.com/forums/t/can-the-card-fingerprint-be-determined-before-a-payment/20188 "2024-12-20T23:52:30Z")
What goes into creating the card fingerprint? Is it possible for me to determine the card fingerprint based on details from the credit card and other user details? My goal is to create a way to connect a customer in my d… --- ## [Execute payment with previously saved card](https://developer.squareup.com/forums/t/execute-payment-with-previously-saved-card/20112)
**Author:** [@axel21](https://developer.squareup.com/forums/u/axel21)\ **Replies:** 3\ **Last updated:** [December 16, 2024, 6:20pm UTC](https://developer.squareup.com/forums/t/execute-payment-with-previously-saved-card/20112 "2024-12-16T18:20:53Z")
Hi I need to make a payment with the card that was attached to the customer. how could I do that? the goal is to have some clients with saved cards and to have possibility to charge their cards, but its not a recurren… --- ## [Does the card tokenize response have a timeout? How long is it?](https://developer.squareup.com/forums/t/does-the-card-tokenize-response-have-a-timeout-how-long-is-it/19109)
**Author:** [@dmelo](https://developer.squareup.com/forums/u/dmelo)\ **Replies:** 2\ **Last updated:** [October 10, 2024, 5:28pm UTC](https://developer.squareup.com/forums/t/does-the-card-tokenize-response-have-a-timeout-how-long-is-it/19109 "2024-10-10T17:28:02Z")
I’m following this tutorial Online Payments with Square and React. Using the Square Web Payments SDK to allow the user to fill in his card details. I get a token after that interaction. I use that token for a payment. M… [Next page](https://developer.squareup.com/forums/tag/cards-api/54.md?match_all_tags=true&page=1&tags%5B%5D=cards-api)