Automatic Credit Card Surcharge not applied to Invoices API-created invoices

Questions
1

I need confirmation about Square Automatic Credit Card Surcharge behavior with invoices created using the Invoices API.

Our Square location Inside Out Supply has a 3% Automatic Credit Card Surcharge enabled in Square Dashboard.

We tested this in Production:

  1. A manually created Square Dashboard invoice correctly applies the configured 3% surcharge to an eligible credit card.
  2. An invoice created using the Invoices API with delivery_method: SHARE_MANUALLY offered both card and Bank (ACH), but after entering an eligible credit card on the Square-hosted invoice payment page, the surcharge was not added.
  3. We repeated the test with delivery_method: EMAIL. Same result.

In both API-created tests, the invoice amount was $10.00. After entering the eligible credit card, the hosted page still displayed $10.00 rather than $10.30. We did not complete the payment.

We are using the Production API, the correct Square location, and the location’s Dashboard Automatic Credit Card Surcharge setting is enabled.

Our application intentionally does not pre-add a surcharge because we want Square to determine whether the card is credit versus debit and whether the transaction is surcharge-eligible.

Could a Square Developer Advocate please answer these specifically:

1. Does Square Automatic Credit Card Surcharge currently support invoices created using the Invoices API?

2. If yes, what exact API field, request parameter, invoice setting, Orders API field, or location configuration causes an API-created invoice to inherit the Dashboard surcharge?

3. Does delivery_method: EMAIL versus SHARE_MANUALLY affect surcharge behavior?

4. Is there any Invoices API or Orders API field that tells Square to apply the location’s configured Automatic Credit Card Surcharge?

5. If Automatic Credit Card Surcharge is not supported for Invoices API-created invoices, please confirm that explicitly.

6. If it is not supported, what API-supported architecture does Square recommend for this required behavior?

  • ACH = original invoice amount, no surcharge
  • eligible credit card = original amount + 3%
  • debit card = original amount, no surcharge

We need Square to determine card eligibility so our application does not accidentally surcharge debit or otherwise ineligible cards.

If Square currently has no API-supported way to produce that exact customer experience, please confirm that as well.

3

Hi @Marc - Invoices created via the Invoices API does not support automatic credit card surcharges. The closest option would be to attach a service charge to the order, but this would apply to all orders and resulting invoices regardless of payment method.