# Invoice Payment (/en/api-reference/objects/invoice-payment)

An Invoice Payment is one payment made on an invoice. An invoice can have several: one per part payment or installment. A payment is backed by a PaymentIntent when the customer paid online, or by a payment record when the merchant recorded money received outside XPay, such as cash or a cheque. Money returned from a payment is shown in amountRefunded and documented by a credit note; the payment's status stays paid.

## Fields

- `id` (string, required) — Invoice payment ID
- `object` (enum("invoice_payment"), required) — Object type
- `invoiceId` (string, required) — Invoice the payment belongs to
- `status` (enum("open" | "paid" | "canceled"), required) — open, paid or canceled
- `amountRequested` (integer, required) — Amount this payment was started for, in minor units
- `amountPaid` (integer | null, required) — Amount received, in minor units. Null until the payment is paid.
- `amountRefunded` (integer, required) — Returned to the customer from this payment, in minor units
- `currency` (enum("EGP" | "USD" | "EUR" | "GBP" | "SAR" | "AED" | "QAR" | "KWD" | "JOD" | "OMR" | "BHD" | "LYD" | "AUD" | "CAD" | "CNY"), required) — Currency
- `payment` (object, required) — What stands behind this payment
  - `type` (enum("payment_intent" | "payment_record"), required) — payment_intent for an online payment, payment_record for a recorded one
  - `paymentIntentId` (string | null, required) — PaymentIntent behind an online payment
  - `checkoutSessionId` (string | null, required) — Checkout session the customer paid through
  - `paymentRecord` (object | null, required) — Details of a payment the merchant recorded
    - `method` (enum("cash" | "bank_transfer" | "cheque" | "other"), required) — How the money was received
    - `reference` (string | null, required) — Transfer or cheque number
    - `note` (string | null, required) — Merchant note, not shown to the customer
- `statusTransitions` (object, required) — When the payment reached each status
  - `paidAt` (string | null, required) — When the payment was received (ISO 8601)
  - `canceledAt` (string | null, required) — When the payment was given up (ISO 8601)
- `installmentId` (string | null, required) — Installment the payment was started for, if any
- `receiptNumber` (string | null, required) — Receipt number, such as 2830-5289, set once the payment is paid
- `receiptUrl` (string | null, required) — The receipt's page for the customer, set once the payment is paid
- `merchantId` (string, required) — Merchant ID
- `createdAt` (string, required) — Created timestamp (ISO 8601)
- `updatedAt` (string, required) — Updated timestamp (ISO 8601)