POS-side input for submitting a payment on completion
A single payment line on an operation. amount is always a positive
integer — direction carries the sign semantic.
inbound: money flows from customer to merchant (customer pays)outbound: money flows from merchant to customer (change, refunds)Include a method-specific sub-object when you have details to attach.
Only the sub-object matching method is considered; others are ignored.
cash, card, wallet, voucher, gift_card, online, other Direction of money flow.
inbound: customer pays merchant.
outbound: merchant pays customer (change, refund payout).
inbound, outbound Always a positive integer in minor currency units
4250
Defaults to the operation currency if omitted
External transaction reference from your payment processor. Stored and returned as-is. Useful for reconciliation.
Present when method is cash
Present when method is card
Present when method is wallet (Apple Pay, Google Pay, etc).
Wallet payments are card-present NFC transactions. Distinct from
card because some jurisdictions require the wallet provider on
the receipt.
Present when method is voucher
Present when method is gift_card
Present when method is online. Covers remote payment providers
(PayPal, Klarna, bank transfer) — distinct from wallet which is
card-present NFC.