Skip to content

Latest commit

 

History

History
75 lines (66 loc) · 3.32 KB

refund.md

File metadata and controls

75 lines (66 loc) · 3.32 KB

Refund

Represents a refund processed for a Square transaction.

Structure

Refund

Fields

Name Type Tags Description
id string Required The refund's unique ID.
Constraints: Maximum Length: 255
location_id string Required The ID of the refund's associated location.
Constraints: Maximum Length: 50
transaction_id string Required The ID of the transaction that the refunded tender is part of.
Constraints: Maximum Length: 192
tender_id string Required The ID of the refunded tender.
Constraints: Maximum Length: 192
created_at string Optional The timestamp for when the refund was created, in RFC 3339 format.
Constraints: Maximum Length: 32
reason string Required The reason for the refund being issued.
Constraints: Maximum Length: 192
amount_money Money Required Represents an amount of money. Money fields can be signed or unsigned.
Fields that do not explicitly define whether they are signed or unsigned are
considered unsigned and can only hold positive amounts. For signed fields, the
sign of the value indicates the purpose of the money transfer. See
Working with Monetary Amounts
for more information.
status str (Refund Status) Required Indicates a refund's current status.
processing_fee_money Money Optional Represents an amount of money. Money fields can be signed or unsigned.
Fields that do not explicitly define whether they are signed or unsigned are
considered unsigned and can only hold positive amounts. For signed fields, the
sign of the value indicates the purpose of the money transfer. See
Working with Monetary Amounts
for more information.
additional_recipients List of Additional Recipient Optional Additional recipients (other than the merchant) receiving a portion of this refund.
For example, fees assessed on a refund of a purchase by a third party integration.

Example (as JSON)

{
  "id": "id0",
  "location_id": "location_id4",
  "transaction_id": "transaction_id8",
  "tender_id": "tender_id8",
  "created_at": "created_at2",
  "reason": "reason4",
  "amount_money": {
    "amount": 186,
    "currency": "NGN"
  },
  "status": "PENDING",
  "processing_fee_money": {
    "amount": 112,
    "currency": "XBB"
  },
  "additional_recipients": [
    {
      "location_id": "location_id3",
      "description": "description9",
      "amount_money": {
        "amount": 83,
        "currency": "ALL"
      },
      "receivable_id": "receivable_id9"
    },
    {
      "location_id": "location_id4",
      "description": "description0",
      "amount_money": {
        "amount": 84,
        "currency": "AMD"
      },
      "receivable_id": "receivable_id0"
    },
    {
      "location_id": "location_id5",
      "description": "description1",
      "amount_money": {
        "amount": 85,
        "currency": "ANG"
      },
      "receivable_id": "receivable_id1"
    }
  ]
}