AlmondTill/G3N API

RefundTenderInput

input type

Refund-input for refundTender: a POSITIVE magnitude (the port stamps the negative sign); cap = the net tendered (CONFLICT/OVER_TENDERED); cash is live; the stored-value types joined.

Fields

FieldTypeRequiredNotes
orderIdID ID!yesNo further notes.
expectedRevisionID ID!yesThe Order revision the caller read.
tenderTypeTenderType TenderType!yescash + the stored-value types are live; card refunds ride the processor path; recorded external-card refunds ride the Return lane.
amountMinorInt Int!yesThe POSITIVE magnitude to refund in minor units.
tillSessionIdIDnoThe OPEN drawer session paying out — REQUIRED for cash, REFUSED otherwise.
instrumentTenderInstrumentInputnoThe EXPLICIT instrument refund target — REQUIRED for stored-value types, REFUSED otherwise: a refund_reversal credits it in ONE transaction; a depleted target RE-OPENS (system:refund_credit); doomed/inactive refuse CONFLICT/REF_STATE.
reasonString String!yesREQUIRED — money leaves the business (at most 256 characters). When the refund credits a house account (on_account) the reason is recorded on that ledger too — at most 256 characters there.
captionStringnoNo further notes.
refsString [String!]noNo further notes.

Used by