Hi guys,
We are having an issue where if we have sent an invoice (order) to to square via the API, the terminal throws an error when we try to take a payment.
Here is some of the webhook data:
{
"merchant_id": "MLJBW6SCHHJVR",
"type": "payment.updated",
"event_id": "e0c10a09-01dd-329d-8d32-eb986f2b71db",
"created_at": "2025-09-17T10:46:14.789Z",
"data": {
"type": "payment",
"id": "rBMJt5wUP42LAUoGMQvL6XzfXtKZY",
"object": {
"payment": {
"amount_money": {
"amount": 108,
"currency": "GBP"
},
"application_details": {
"application_id": "sq0idp-tIBDfGjufC_BWePHQE9I7Q",
"square_product": "TERMINAL_API"
},
"approved_money": {
"amount": 108,
"currency": "GBP"
},
"capabilities": [
"EDIT_AMOUNT_UP",
"EDIT_AMOUNT_DOWN",
"EDIT_TIP_AMOUNT_UP",
"EDIT_TIP_AMOUNT_DOWN"
],
"card_details": {
"application_cryptogram": "2760de620099ca30",
"application_identifier": "A0000000041010",
"application_name": "Debit Mastercard",
"auth_result_code": "Se265R",
"avs_status": "AVS_NOT_CHECKED",
"card": {
"bin": "535744",
"card_brand": "MASTERCARD",
"card_type": "DEBIT",
"exp_month": 1,
"exp_year": 2026,
"fingerprint": "sq-1-LtKe-F41QzSP36Di-Ra3f0A61RZtEPsvjBX2Md2XaZmW8UanptkqlpDi-XrZ-hdSXQ",
"last_4": "7402",
"payment_account_reference": "5001DAT1UB4ONI69KQ916IFM215IS",
"prepaid_type": "NOT_PREPAID"
},
"card_payment_timeline": {
"authorized_at": "2025-09-17T10:46:13.710Z",
"voided_at": "2025-09-17T10:46:14.780Z"
},
"cvv_status": "CVV_NOT_CHECKED",
"device_details": {
"device_id": "429CS145B9001160",
"device_installation_id": "39102359-d394-4556-9948-eb18ed47d4c8",
"device_name": "Square Terminal 1160"
},
"emv_details": {
"authorization_response_code": "3030"
},
"entry_method": "CONTACTLESS",
"statement_description": "SQ *BIKEBOOK",
"status": "AUTHORIZED",
"verification_method": "NONE",
"verification_results": "SUCCESS"
},
"created_at": "2025-09-17T10:46:13.140Z",
"customer_id": "MSPA41M8SW10D38KQ92JZAT3RM",
"delay_action": "CANCEL",
"delay_duration": "PT36H",
"delayed_until": "2025-09-18T22:46:13.140Z",
"device_details": {
"device_id": "429CS145B9001160",
"device_installation_id": "39102359-d394-4556-9948-eb18ed47d4c8",
"device_name": "Square Terminal 1160"
},
"id": "rBMJt5wUP42LAUoGMQvL6XzfXtKZY",
"location_id": "LZGKASMWCKJFC",
"note": "Invoice #10 payment",
"order_id": "CWVgFXOVi7Z8YTOgg8CbsA68FjbZY",
"receipt_number": "rBMJ",
"reference_id": "#INV-10-63[Redacted]809104",
"source_type": "CARD",
"status": "APPROVED",
"terminal_checkout_id": "metqqaJZZNYqO",
"total_money": {
"amount": 108,
"currency": "GBP"
},
"updated_at": "2025-09-17T10:46:14.780Z",
"version": 2
}
}
}
}
The device just shows the following after trying to take the payment with a card:
I can't seem to find any errors anywhere as it just seems to be on the device, it does however work fine if I don't try attach a order id to the checkout.
I have a bunch more webhooks if you need, although you should be able to see the checkout ID in that one and see the rest.
Kind regards,
Sam
Hi @samelson1 - I see this is your first post in the Square Community so I'd like to officially welcome you! ๐๐ My name is Violet and I'm one of the Square Community Moderators.
If you haven't already, please reach out to our API Support Team directly via our Developer Forum, where their team can assist with any API-related inquiries. You may also find this resource helpful. You can also find payment troubleshooting steps for the Square Terminal here in our Support Center.
Hi @samelson1 - I see this is your first post in the Square Community so I'd like to officially welcome you! ๐๐ My name is Violet and I'm one of the Square Community Moderators.
If you haven't already, please reach out to our API Support Team directly via our Developer Forum, where their team can assist with any API-related inquiries. You may also find this resource helpful. You can also find payment troubleshooting steps for the Square Terminal here in our Support Center.
Square Community
Square Products