Update payment in Square
POS API · write, waits for approval · 100% field coverage
Your agent can update payment in Square through Apideck's POS API, the same call it makes for every POS app. It changes data in the customer's Square account, so it stops with the exact request until a person approves it. Apideck adds the customer's Square credentials, so no token ever reaches the agent.
The call
PATCH https://unify.apideck.com/pos/payments/{id}
Headers: x-apideck-service-id: square, plus your app id and the customer's consumer id. Apideck MCP tool: pos-payments-update. Agent operation id: unified.pos.paymentsUpdate.
| Parameter | In | Description |
|---|---|---|
| id · required | path | ID of the record you are acting upon. |
Body fields
| Field | Type | Description |
|---|---|---|
| source_id · required | string | The ID for the source of funds for this payment. Square-only: This can be a payment token (card nonce) generated by the |
| order_id · required | string | |
| merchant_id | string | |
| customer_id · required | string | |
| employee_id | string | |
| location_id | string | |
| device_id | string | |
| tender_id · required | string | |
| external_payment_id | string | |
| idempotency_key | string | A value you specify that uniquely identifies this request among requests you have sent. |
| amount · required | number | |
| currency · required | string | Indicates the associated currency for an amount of money. Values correspond to [ISO 4217](https://en.wikipedia.org/wiki/ |
| tip | number | |
| tax | number | |
| total | number | |
| app_fee | number | The amount the developer is taking as a fee for facilitating the payment on behalf of the seller. |
| change_back_cash_amount | number | |
| approved | number | The initial amount of money approved for this payment. |
| refunded | number | The initial amount of money approved for this payment. |
| processing_fees | array | |
| source | string | Source of this payment. |
| status | string | Status of this payment. |
| cash | object | Cash details for this payment |
| card_details | object | |
| bank_account | object | Card details for this payment. This field is currently not available. Reach out to our team for more info. |
| wallet | object | Wallet details for this payment. This field is currently not available. Reach out to our team for more info. |
| external_details | object | Details about an external payment. |
| service_charges | array | Optional service charges or gratuity tip applied to the order. |