Valid Payment Link Tender Types

Hello. I am implementing payment links using the Checkout API. Once the customer completes the payment, I retrieve the resulting order and check each tender type so I can process it accordingly. For example, if the tender type is CARD, I create a credit card payment in our ERP system.

My first question is which tender types apply specifically to payment links? The Orders API documentation lists all available tender types for an order, but some of those may not apply to payment links. For example, payment link checkout doesn’t provide an option to pay with cash, so my guess is the CASH tender type would not apply.

My second question is what would be the tender type for a payment link order that was paid with Apple/Google Pay, but the configured payment method in Apple/Google Pay is a bank account instead of a credit card? Would the tender type be WALLET or BANK_ACCOUNT? If it is BANK_ACCOUNT, we are on an older version of the Square API (2022-05-12) that doesn’t have a BANK_ACCOUNT tender type so how would that work?

Thank you for your help.

:wave: 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:

Additional Documentation

Take Payments
Cash App Payments
Take Payments

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.

For your first question, the tender types that apply to payment links created using the Checkout API would be those that are supported by the Square-hosted checkout pages. These include CARD for credit and debit card payments, and WALLET for digital wallet payments such as Apple Pay and Google Pay. As you correctly noted, CASH would not apply since cash payments are not supported on online checkout pages.

For your second question, if a customer uses Apple Pay or Google Pay with a bank account as the payment method, the tender type would still be WALLET. This is because from Square’s perspective, the payment is being processed as a digital wallet payment, regardless of the underlying payment method configured in the customer’s Apple Pay or Google Pay wallet. Therefore, even if you’re on an older version of the Square API that doesn’t have a BANK_ACCOUNT tender type, it should not affect your ability to process these payments.

This answer was reviewed by @Bryan-Square.

For your first question, the tender types that apply to payment links created using the Checkout API would be those that are supported by the Square-hosted checkout pages. These include CARD for credit and debit card payments, and WALLET for digital wallet payments such as Apple Pay and Google Pay. As you correctly noted, CASH would not apply since cash payments are not supported on online checkout pages.

For your second question, if a customer uses Apple Pay or Google Pay with a bank account as the payment method, the tender type would still be WALLET. This is because from Square’s perspective, the payment is being processed as a digital wallet payment, regardless of the underlying payment method configured in the customer’s Apple Pay or Google Pay wallet. Therefore, even if you’re on an older version of the Square API that doesn’t have a BANK_ACCOUNT tender type, it should not affect your ability to process these payments.

This answer was reviewed by @Bryan-Square.

I did some live testing and noticed that the tender type was CARD for both credit and debit card payments and Apple/Google Pay payments. Just wanted to note this for other people who come across this thread.

Yes, that is expected. The additional details about the card and entry method are in the card_details of the payment. :slightly_smiling_face: