action squareup_retrieve_payment {
label: "RetrievePayment"
description: "Provides comprehensive information for a single payment."
provider: squareup
method: GET
path: "/v1/{location_id}/payments/{payment_id}"
encoding: json
input: {
type: "object"
properties: {
location_id: {
type: "string"
}
payment_id: {
type: "string"
}
}
required: ["location_id", "payment_id"]
additionalProperties: false
}
output: {
type: "object"
description: "A payment represents a paid transaction between a Square merchant and a\ncustomer. Payment details are usually available from Connect API endpoints\nwithin a few minutes after the transaction completes.\n\nEach Payment object includes several fields that end in `_money`. These fields\ndescribe the various amounts of money that contribute to the payment total:\n\n
\n- \nMonetary values are positive if they represent an\nincrease in the amount of money the merchant receives (e.g.,\n
tax_money, tip_money).\n \n- \nMonetary values are negative if they represent an\ndecrease in the amount of money the merchant receives (e.g.,\n
discount_money, refunded_money).\n \n
"
properties: {
additive_tax: {
type: "array"
description: "All of the additive taxes associated with the payment."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
additive_tax_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
created_at: {
type: "string"
description: "The time when the payment was created, in ISO 8601 format. Reflects the time of the first payment if the object represents an incomplete partial payment, and the time of the last or complete payment otherwise."
}
creator_id: {
type: "string"
description: "The unique identifier of the Square account that took the payment."
}
device: {
type: "object"
properties: {
id: {
type: "string"
description: "The device's Square-issued ID."
}
name: {
type: "string"
description: "The device's merchant-specified name."
}
}
}
discount_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
gross_sales_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
id: {
type: "string"
description: "The payment's unique identifier."
}
inclusive_tax: {
type: "array"
description: "All of the inclusive taxes associated with the payment."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
inclusive_tax_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
is_partial: {
type: "boolean"
description: "Indicates whether or not the payment is only partially paid for.\nIf true, this payment will have the tenders collected so far, but the\nitemizations will be empty until the payment is completed."
}
itemizations: {
type: "array"
description: "The items purchased in the payment."
items: {
type: "object"
description: "Payment include an` itemizations` field that lists the items purchased,\nalong with associated fees, modifiers, and discounts. Each itemization has an\n`itemization_type` field that indicates which of the following the itemization\nrepresents:\n\n\n- An item variation from the merchant's item library
\n- A custom monetary amount
\n- \nAn action performed on a Square gift card, such as activating or\nreloading it.\n
\n
\n\n*Note**: itemization information included in a `Payment` object reflects\ndetails collected **at the time of the payment**. Details such as the name or\nprice of items might have changed since the payment was processed."
properties: {
discount_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
discounts: {
type: "array"
description: "All discounts applied to this itemization."
items: {
type: "object"
description: "V1PaymentDiscount"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
discount_id: {
type: "string"
description: "The ID of the applied discount, if available. Discounts applied in older versions of Square Register might not have an ID."
}
name: {
type: "string"
description: "The discount's name."
}
}
}
}
gross_sales_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
item_detail: {
type: "object"
description: "V1PaymentItemDetail"
properties: {
category_name: {
type: "string"
description: "The name of the item's merchant-defined category, if any."
}
item_id: {
type: "string"
description: "The unique ID of the item purchased, if any."
}
item_variation_id: {
type: "string"
description: "The unique ID of the item variation purchased, if any."
}
sku: {
type: "string"
description: " The item's merchant-defined SKU, if any."
}
}
}
item_variation_name: {
type: "string"
description: "The name of the item variation purchased, if any."
}
itemization_type: {
type: "string"
description: "The type of purchase that the itemization represents, such as an ITEM or CUSTOM_AMOUNT"
}
modifiers: {
type: "array"
description: "All modifier options applied to this itemization."
items: {
type: "object"
description: "V1PaymentModifier"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
modifier_option_id: {
type: "string"
description: "The ID of the applied modifier option, if available. Modifier options applied in older versions of Square Register might not have an ID."
}
name: {
type: "string"
description: "The modifier option's name."
}
}
}
}
name: {
type: "string"
description: "The item's name."
}
net_sales_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
notes: {
type: "string"
description: "Notes entered by the merchant about the item at the time of payment, if any."
}
quantity: {
type: "number"
description: "The quantity of the item purchased. This can be a decimal value."
}
single_quantity_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
taxes: {
type: "array"
description: "All taxes applied to this itemization."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
total_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
}
}
}
merchant_id: {
type: "string"
description: "The unique identifier of the merchant that took the payment."
}
net_sales_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
net_total_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
payment_url: {
type: "string"
description: "The URL of the payment's detail page in the merchant dashboard. The merchant must be signed in to the merchant dashboard to view this page."
}
processing_fee_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
receipt_url: {
type: "string"
description: "The URL of the receipt for the payment. Note that for split tender\npayments, this URL corresponds to the receipt for the first tender\nlisted in the payment's tender field. Each Tender object has its own\nreceipt_url field you can use to get the other receipts associated with\na split tender payment."
}
refunded_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunds: {
type: "array"
description: "All of the refunds applied to the payment. Note that the value of all refunds on a payment can exceed the value of all tenders if a merchant chooses to refund money to a tender after previously accepting returned goods as part of an exchange."
items: {
type: "object"
description: "V1Refund"
properties: {
created_at: {
type: "string"
description: "The time when the merchant initiated the refund for Square to process, in ISO 8601 format."
}
is_exchange: {
type: "boolean"
description: "Indicates whether or not the refund is associated with an exchange. If is_exchange is true, the refund reflects the value of goods returned in the exchange not the total money refunded."
}
merchant_id: {
type: "string"
}
payment_id: {
type: "string"
description: "A Square-issued ID associated with the refund. For single-tender refunds, payment_id is the ID of the original payment ID. For split-tender refunds, payment_id is the ID of the original tender. For exchange-based refunds (is_exchange == true), payment_id is the ID of the original payment ID even if the payment includes other tenders."
}
processed_at: {
type: "string"
description: "The time when Square processed the refund on behalf of the merchant, in ISO 8601 format."
}
reason: {
type: "string"
description: "The merchant-specified reason for the refund."
}
refunded_additive_tax: {
type: "array"
description: "All of the additive taxes associated with the refund."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
refunded_additive_tax_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_discount_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_inclusive_tax: {
type: "array"
description: "All of the inclusive taxes associated with the refund."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
refunded_inclusive_tax_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_processing_fee_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_surcharge_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_surcharges: {
type: "array"
description: "A list of all surcharges associated with the refund."
items: {
type: "object"
description: "V1PaymentSurcharge"
properties: {
amount_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
name: {
type: "string"
description: "The name of the surcharge."
}
rate: {
type: "string"
description: "The amount of the surcharge as a percentage. The percentage is provided as a string representing the decimal equivalent of the percentage. For example, \"0.7\" corresponds to a 7% surcharge. Exactly one of rate or amount_money should be set."
}
surcharge_id: {
type: "string"
description: "A Square-issued unique identifier associated with the surcharge."
}
taxable: {
type: "boolean"
description: "Indicates whether the surcharge is taxable."
}
taxes: {
type: "array"
description: "The list of taxes that should be applied to the surcharge."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
type: {
type: "string"
description: "Indicates the source of the surcharge. For example, if it was applied as an automatic gratuity for a large group."
}
}
}
}
refunded_tax_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
refunded_tip_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
type: {
type: "string"
description: "The type of refund"
}
}
}
}
surcharge_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
surcharges: {
type: "array"
description: "A list of all surcharges associated with the payment."
items: {
type: "object"
description: "V1PaymentSurcharge"
properties: {
amount_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
name: {
type: "string"
description: "The name of the surcharge."
}
rate: {
type: "string"
description: "The amount of the surcharge as a percentage. The percentage is provided as a string representing the decimal equivalent of the percentage. For example, \"0.7\" corresponds to a 7% surcharge. Exactly one of rate or amount_money should be set."
}
surcharge_id: {
type: "string"
description: "A Square-issued unique identifier associated with the surcharge."
}
taxable: {
type: "boolean"
description: "Indicates whether the surcharge is taxable."
}
taxes: {
type: "array"
description: "The list of taxes that should be applied to the surcharge."
items: {
type: "object"
description: "V1PaymentTax"
properties: {
applied_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
errors: {
type: "array"
description: "Any errors that occurred during the request."
items: {
type: "object"
description: "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information."
required: ["category", "code"]
properties: {
category: {
type: "string"
description: "The high-level category for the error."
}
code: {
type: "string"
description: "The specific code of the error."
}
detail: {
type: "string"
description: "A human-readable description of the error for debugging purposes."
}
field: {
type: "string"
description: "The name of the field provided in the original request (if any) that\nthe error pertains to."
}
}
}
}
fee_id: {
type: "string"
description: "The ID of the tax, if available. Taxes applied in older versions of Square Register might not have an ID."
}
inclusion_type: {
type: "string"
description: "Whether the tax is an ADDITIVE tax or an INCLUSIVE tax."
}
name: {
type: "string"
description: "The merchant-defined name of the tax."
}
rate: {
type: "string"
description: "The rate of the tax, as a string representation of a decimal number. A value of 0.07 corresponds to a rate of 7%."
}
}
}
}
type: {
type: "string"
description: "Indicates the source of the surcharge. For example, if it was applied as an automatic gratuity for a large group."
}
}
}
}
swedish_rounding_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
tax_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
tender: {
type: "array"
description: "All of the tenders associated with the payment."
items: {
type: "object"
description: "A tender represents a discrete monetary exchange. Square represents this\nexchange as a money object with a specific currency and amount, where the\namount is given in the smallest denomination of the given currency.\n\nSquare POS can accept more than one form of tender for a single payment (such\nas by splitting a bill between a credit card and a gift card). The `tender`\nfield of the Payment object lists all forms of tender used for the payment.\n\nSplit tender payments behave slightly differently from single tender payments:\n\nThe receipt_url for a split tender corresponds only to the first tender listed\nin the tender field. To get the receipt URLs for the remaining tenders, use\nthe receipt_url fields of the corresponding Tender objects.\n\n*A note on gift cards**: when a customer purchases a Square gift card from a\nmerchant, the merchant receives the full amount of the gift card in the\nassociated payment.\n\nWhen that gift card is used as a tender, the balance of the gift card is\nreduced and the merchant receives no funds. A `Tender` object with a type of\n`SQUARE_GIFT_CARD` indicates a gift card was used for some or all of the\nassociated payment."
properties: {
card_brand: {
type: "string"
description: "The brand of credit card provided."
}
change_back_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
employee_id: {
type: "string"
description: "The ID of the employee that processed the tender."
}
entry_method: {
type: "string"
description: "The tender's unique ID."
}
id: {
type: "string"
description: "The tender's unique ID."
}
is_exchange: {
type: "boolean"
description: "Indicates whether or not the tender is associated with an exchange. If is_exchange is true, the tender represents the value of goods returned in an exchange not the actual money paid. The exchange value reduces the tender amounts needed to pay for items purchased in the exchange."
}
name: {
type: "string"
description: "A human-readable description of the tender."
}
pan_suffix: {
type: "string"
description: "The last four digits of the provided credit card's account number."
}
payment_note: {
type: "string"
description: "Notes entered by the merchant about the tender at the time of payment, if any. Typically only present for tender with the type: OTHER."
}
receipt_url: {
type: "string"
description: "The URL of the receipt for the tender."
}
refunded_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
settled_at: {
type: "string"
description: "The time when the tender was settled, in ISO 8601 format."
}
tendered_at: {
type: "string"
description: "The time when the tender was created, in ISO 8601 format."
}
tendered_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
total_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
type: {
type: "string"
description: "The type of tender."
}
}
}
}
tip_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
total_collected_money: {
type: "object"
properties: {
amount: {
type: "integer"
description: "Amount in the lowest denominated value of this Currency. E.g. in USD\nthese are cents, in JPY they are Yen (which do not have a 'cent' concept)."
}
currency_code: {
type: "string"
}
}
}
}
}
}