Square · Example Payload

Payment Example

RestaurantBookingsCatalogCheckoutCustomersDisputesEcommerceFinancial TechnologyGift CardsInventoryInvoicingLaborLocationsLoyaltyMerchantsOrdersPaymentsPoint of SaleRefundsRetailSubscriptionsTeamTerminalWebhooks

Payment Example is an example object payload from Square, with 38 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

idcreated_atupdated_atamount_moneytip_moneytotal_moneyapp_fee_moneyapproved_moneyprocessing_feerefunded_moneystatusdelay_durationdelay_actiondelayed_untilsource_typecard_detailscash_detailsbank_account_detailsexternal_detailswallet_detailsbuy_now_pay_later_detailssquare_account_detailslocation_idorder_idreference_idcustomer_idemployee_idteam_member_idrefund_idsrisk_evaluationbuyer_email_addressbilling_addressshipping_addressnotestatement_description_identifierreceipt_numberreceipt_urlversion_token

Example Payload

Raw ↑ 
{
  "id": "A1B2C3D4E5F6",
  "created_at": "2026-03-15T14:30:00Z",
  "updated_at": "2026-03-15T14:30:00Z",
  "amount_money": {
    "amount": 12345,
    "currency": "USD"
  },
  "tip_money": {
    "amount": 44688,
    "currency": "USD"
  },
  "total_money": {
    "amount": 19109,
    "currency": "USD"
  },
  "app_fee_money": {
    "amount": 5867,
    "currency": "USD"
  },
  "approved_money": {
    "amount": 43490,
    "currency": "USD"
  },
  "processing_fee": [
    {
      "effective_at": "2026-03-15T14:30:00Z",
      "type": "sample-value",
      "amount_money": {
        "amount": 42756,
        "currency": "USD"
      }
    }
  ],
  "refunded_money": {
    "amount": 7945,
    "currency": "USD"
  },
  "status": "FAILED",
  "delay_duration": "sample-value",
  "delay_action": "CANCEL",
  "delayed_until": "2026-03-15T14:30:00Z",
  "source_type": "WALLET",
  "card_details": {},
  "cash_details": {
    "buyer_supplied_money": {
      "amount": 46320,
      "currency": "USD"
    },
    "change_back_money": {
      "amount": 6320,
      "currency": "USD"
    }
  },
  "bank_account_details": {},
  "external_details": {},
  "wallet_details": {},
  "buy_now_pay_later_details": {},
  "square_account_details": {},
  "location_id": "A1B2C3D4E5F6",
  "order_id": "A1B2C3D4E5F6",
  "reference_id": "A1B2C3D4E5F6",
  "customer_id": "A1B2C3D4E5F6",
  "employee_id": "A1B2C3D4E5F6",
  "team_member_id": "A1B2C3D4E5F6",
  "refund_ids": [
    "sample-value"
  ],
  "risk_evaluation": {
    "created_at": "2026-03-15T14:30:00Z",
    "risk_level": "PENDING"
  },
  "buyer_email_address": "buyer@example.com",
  "billing_address": {},
  "shipping_address": {},
  "note": "Sample Square record.",
  "statement_description_identifier": "Sample Square record.",
  "receipt_number": "SAMP",
  "receipt_url": "https://squareup.com/receipt/abc123",
  "version_token": "sample-value"
}