List the payments of a sales order

GET/v2/api/store/{team_slug}/v2/sales_order/{hash_id}/payment

v2Operation ID v2_public_sales_order_payment_index

Returns every money record on an order, newest first and all at once (no pagination): payments, refunds, customer credit moves (subtype TRANSFER), voided card payments, Shopify payments, and payments the customer made in the customer portal (action CUSTOMER_CHECKOUT) with their refunds and lost disputes (CUSTOMER_CHECKOUT_CHARGEBACK). It also lists the records YoPrint adds itself: credit a refund took back (ORDER_CREDIT_RECOVERY), credit given back when that refund failed (ORDER_CREDIT_RESTORED), and money returned to a payment when its card refund failed (REFUND_REVERSAL). Refunds and other money out have a negative amount.

Card payments also say whether they are frozen by a dispute (has_open_hold, payment_freeze_reason, payment_notices). {hash_id} is the order's id (for example V4keXwwxMQyXw7); the ord_ unique key is not accepted here.

Permission

Any member of the team.

Path parameters

team_slugstringrequired
Your team slug, shown as Team ID next to your API key in Profile.
- Example your-team
hash_idstringrequired
The sales order's or quote's id (a hash id). The ord_ unique key and the order number do not work here.
- Example V4keXwwxMQyXw7

Request body

This operation takes no request body.

Response

200Successful response.

dataarray of objectsrequired
Newest first.
Fields of each item (36)
- amountinteger | number | string | nullrequired
  Signed: negative for DECREASE (a 25.00 refund is -25000). Thousandths, an older encoding: 12500 is 12.50. Usually a whole number; an amount finer than a thousandth comes back as a number with a fraction (1234.5 is 1.2345), or as a string ("1234.5") when you send X-Yoprint-Decimal-Format: exact-v1. See Money and quantities.
- idstringrequired
- actionstring | null
  ORDER_PAYMENT, ORDER_REFUND, ORDER_CREDIT_DEPOSIT (paid from customer credit), ORDER_CREDIT_WITHDRAW (moved to customer credit), ORDER_CREDIT_RECOVERY, ORDER_CREDIT_RESTORED, CUSTOMER_CHECKOUT (paid in the customer portal, and its refunds), CUSTOMER_CHECKOUT_CHARGEBACK (a lost dispute), or the gateway: STRIPE, SQUARE, SQUARE_V2, PAYPAL, AUTHORIZE_NET, CHARGE_IT_PRO. A REFUND_REVERSAL carries its refund's gateway.
- credit_sourceobject | null
  Where a customer credit record came from. Always present; null on an order's records.
- credit_source_payment_idstring | null
  ORDER_CREDIT_RECOVERY and ORDER_CREDIT_RESTORED only: the payment the credit was issued from.
- customer_idstring | null
  Always null on an order's records.
- customer_payment_funding_idstring | null
  Customer Portal payment rows and credit applied from one only: the customer payment it belongs to.
- customer_payment_sourcesarray of objects
  Customer Portal rows only: the customer payments the money came from, each with customer_payment_funding_id, funding_transaction_id, amount (a decimal string) and currency_iso.
- datestring (date-time) | null
  When it was recorded (the payment date you sent). ISO 8601 with offset, or null.
- delete_blocked_reasonobject | null
  Recorded payments (ORDER_PAYMENT) and card payments only: why Delete a payment or refund refuses it, or null when it can be deleted. code is credit_issued_from_payment (with amount, a decimal string) or provider_payment_not_removable; message is the refusal's text.
  Child fields (3)
  - amountstring
  - codestring
  - messagestring
- directionstring
  INCREASE (payments, payments from customer credit, REFUND_REVERSAL, ORDER_CREDIT_RECOVERY) or DECREASE (refunds and lost disputes, moves to customer credit, card voids, ORDER_CREDIT_RESTORED).
- funding_payment_gatewaystring | null
  Customer Portal rows only: the provider (STRIPE, PAYPAL, SQUARE_V2, AUTHORIZE_NET, CHARGE_IT_PRO) or null.
- has_open_holdboolean
  List and Get only, on STRIPE, PAYPAL and SQUARE_V2 card payments and Customer Portal payments: true while a dispute (or, for a Customer Portal payment, a review) is open.
- is_deletableboolean
  false for card payments, Customer Portal payments, credit moves, card refunds, payments part of which moved to customer credit (and their refunds), refunds recorded against card payments, and the records YoPrint adds itself.
- is_editableboolean
  true only for recorded payments (ORDER_PAYMENT).
- negative_credit_amountinteger | number | string | null
  Card refunds only: credit issued from the payment that the customer had already spent and the refund took back anyway, leaving their credit negative (usually 0). Thousandths, an older encoding: 12500 is 12.50. Usually a whole number; an amount finer than a thousandth comes back as a number with a fraction (1234.5 is 1.2345), or as a string ("1234.5") when you send X-Yoprint-Decimal-Format: exact-v1. See Money and quantities.
- order_idstring | null
- payment_freeze_reasonstring | null
  List and Get only, on STRIPE, PAYPAL and SQUARE_V2 card payments and direct Customer Portal payments: chargeback_open or payment_under_review while refunds and credit moves are refused, otherwise null.
- payment_gatewaystring | null
  The gateway (STRIPE, SQUARE_V2 and so on) for card payments and refunds; for a Customer Portal payment its provider (null when unknown), and CUSTOMER_CHECKOUT or CUSTOMER_CHECKOUT_CHARGEBACK on its refunds and lost disputes; null otherwise.
- payment_gateway_sourcestring | null
  Card payments and refunds only: Square v2's source type (for example CARD), otherwise null.
- payment_method_idstring | null
  Refunds take their payment's; null for card payments and credit moves.
- payment_noticesarray of objects
  List and Get only, on the same payments as has_open_hold: one notice per open dispute.
  Fields of each item (10)
  - amountobject | null
    The disputed amount as a decimal pair with dp 3, or null when the payment covered several orders.
  - codestring
    dispute_open or dispute_under_review; on Customer Portal payments also payment_needs_attention.
  - currency_isostring
  - customer_payment_dispute_idstring
  - customer_payment_funding_idstring | null
  - deadline_atstring | null
    When the response to the provider is due (ISO 8601), or null.
  - next_actionstring
    For example respond_to_provider or awaiting_provider.
  - providerstring
  - provider_statusstring
  - stagestring | null
- recovery_kindstring | null
  ORDER_CREDIT_RECOVERY and ORDER_CREDIT_RESTORED only: null on an order's records.
- reference_descriptionstring | null
- reference_idstring | null
- refundable_amountinteger | number | string | null
  Payments only: the amount minus its refunds. Money moved to customer credit is not taken off here, though a refund can't include it. 0 for refunds, credit moves, payments from customer credit, and CHARGE_IT_PRO and SQUARE card payments. Thousandths, an older encoding: 12500 is 12.50. Usually a whole number; an amount finer than a thousandth comes back as a number with a fraction (1234.5 is 1.2345), or as a string ("1234.5") when you send X-Yoprint-Decimal-Format: exact-v1. See Money and quantities.
- related_transactionstring | null
  For a refund, the id of the payment it refunds; for REFUND_REVERSAL, the payment; for ORDER_CREDIT_RECOVERY and ORDER_CREDIT_RESTORED, the refund; null otherwise.
- remove_unavailableobject | null
  Recorded payments only: { "reason": "credit_issued", "amount": <thousandths> } when credit was issued from the payment, otherwise null.
- restores_transaction_idstring | null
  ORDER_CREDIT_RESTORED only: the ORDER_CREDIT_RECOVERY record it gives back.
- reversal_transaction_idstring | null
  Card refunds and ORDER_CREDIT_RESTORED only: the REFUND_REVERSAL record when the refund failed, or null.
- reverses_transaction_idstring | null
  REFUND_REVERSAL only: the failed refund.
- subtypestring
  PAYMENT, REFUND (also a lost dispute), TRANSFER (a customer credit move), ORDER_PAYMENT_VOIDED_NEG_ADJ (a voided card payment), REFUND_REVERSAL (a failed card refund given back to its payment), ORDER_CREDIT_RECOVERY (credit a refund took back) or ORDER_CREDIT_RESTORED (that credit given back when the refund failed).
- tokenstring | null
  The gateway's charge token; null for recorded payments.
- typestring
  MANUAL (recorded in YoPrint) or SYSTEM (card and Customer Portal payments and refunds, Shopify payments, adjustments).
- user_idstring | null
  The team member who recorded it.
- voidedboolean
statusintegerrequired
successbooleanrequired

Errors

401The API key is missing or wrong (unauthenticated).
403You are not allowed to do this. api_access_not_in_plan: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only {"message": "Insufficient Permission"}. Other refusals use the error envelope, with unauthorized or user_is_not_authorized.
404Not found. page_not_found: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. code: null, with a message that starts "No query results for": there is no record with that id.

POSTRecord a payment on a sales order/v2/api/store/{team_slug}/v2/sales_order/{hash_id}/payment
GETGet one payment of a sales order/v2/api/store/{team_slug}/v2/sales_order/{hash_id}/payment/{payment_reference}

Example request

curl

curl 'https://secure.yoprint.com/v2/api/store/your-team/v2/sales_order/V4keXwwxMQyXw7/payment' \  -H 'Authorization: Bearer YOUR_API_KEY' \  -H 'Accept: application/json' \  -H 'X-Yoprint-Decimal-Format: exact-v1'

Example response 200

{
  "data": [
    {
      "action": "ORDER_REFUND",
      "amount": -25000,
      "credit_source": null,
      "customer_id": null,
      "date": "2026-11-05T00:00:00+00:00",
      "direction": "DECREASE",
      "id": "t3FdSWWe9TLyAR",
      "is_deletable": true,
      "is_editable": false,
      "order_id": "V4keXwwxMQyXw7",
      "payment_gateway": null,
      "payment_method_id": "Kst6z3ULXLBrmN",
      "reference_description": "Returned two shirts",
      "reference_id": null,
      "refundable_amount": 0,
      "related_transaction": "hAwWd7vPrqjuHD",
      "subtype": "REFUND",
      "token": null,
      "type": "MANUAL",
      "user_id": "PydH0WtBhSeiNU",
      "voided": false
    },
    {
      "action": "ORDER_PAYMENT",
      "amount": 75000,
      "credit_source": null,
      "customer_id": null,
      "date": "2026-11-03T00:00:00+00:00",
      "delete_blocked_reason": null,
      "direction": "INCREASE",
      "id": "hAwWd7vPrqjuHD",
      "is_deletable": true,
      "is_editable": true,
      "order_id": "V4keXwwxMQyXw7",
      "payment_gateway": null,
      "payment_method_id": "Kst6z3ULXLBrmN",
      "reference_description": null,
      "reference_id": "CHK-1001",
      "refundable_amount": 50000,
      "related_transaction": null,
      "remove_unavailable": null,
      "subtype": "PAYMENT",
      "token": null,
      "type": "MANUAL",
      "user_id": "PydH0WtBhSeiNU",
      "voided": false
    }
  ],
  "status": 200,
  "success": true
}

AI agents: read /llms.txt; add .md to any page URL for its Markdown. Guides and concepts in one file: /llms-full.txt.

Download the OpenAPI spec Support: support@yoprint.com yoprint.com