Expected payment object

An expected payment is a payment that you expect to be credited or debited on your connected account.

While a payment order is initiated through Numeral, an expected payment is a payment that is not initiated through Numeral, but that you nonetheless want to track and reconcile with one or multiple transactions.

An expected payment is typically a payment expected from a customer or a payment service provider.

Attribute	Description
id string	The expected payment ID.
object string	Always `expected_payment`.
connected_account_id string	The ID of the connected account where the payment will be credited or debited.
direction string	Either `credit` or `debit`.
amount_from integer	The payment amount, in the currency's smallest unit. For instance, euro smallest unit is cents and €20 is thus represented as `2000`. If the amount is uncertain, use `amount_from` and `amount_to` attributes to specify an amount range. If the amount is certain, use the same value in both attribute.
amount_to integer	The payment amount, in the currency's smallest unit. For instance, euro smallest unit is cents and €20 is thus represented as `2000`. If the amount is uncertain, use `amount_from` and `amount_to` attributes to specify an amount range. If the amount is certain, use the same value in both attributes.
currency string	The payment currency. All ISO-4217 currency codes are supported.
start_date date	The expected payment date. If the date is uncertain, you can specify the earliest date in `start_date`. If the exact date is certain, the same date can be used in `start_date` and `end_date`.
end_date date	The expected payment date. If the date is uncertain, you can specify the latest date in `start_date`. If the exact date is certain, the same date can be used in `start_date` and `end_date`.
counterparty_account object	The counterparty account. The counterparty is either the debtor or the creditor, depending on the transaction direction. The counterparty_account object includes the following attributes: `account_number`: the account number or IBAN `holder_name`: the name of the company or individual holding the account
counterparty_account_id string	The counterparty account ID. It must be left empty if the `counterparty_account` object is used.
virtual_account_number string	The virtual account number linked to the expected payment.
descriptions array	The payment description. When multiple descriptions can be expected for one payment, they can be added as distinct elements of the `descriptions`array.
reconciliation_status string	The expected payment reconciliation status. Either `unreconciled`, `reconciled`, or `partially_reconciled`.
reconciled_amount integer	The amount reconciled, calculated as the sum of the reconciliations created for this expected payment.
metadata object	Additional data in JSON `key:value` format. See Metadata.
custom_fields object	Custom fields in JSON `key:value` format. See Custom fields.
canceled_at datetime	The expected payment cancelation UTC timestamp.
created_at datetime	The expected payment creation UTC timestamp.
updated_at datetime	The expected payment update UTC timestamp.

Below is an example of an expected payment:

{
   "id": "fdff5955-fb30-4827-993d-3841016e8246",
   "object": "expected_payment",
   "direction": "credit",
   "amount_from": 12000,
   "amount_to": 13000,
   "currency": "EUR",
   "start_date": "2023-01-05",
   "end_date": "2023-01-10",
   "connected_account_id": "a55e3ac4-6956-422f-be98-aa7374482f7c",
   "counterparty_account_id": "b38f5318-a389-4278-9cbe-d16116750982",
   "counterparty_account": {
      "account_number": "FR7601234567890627967100010",
      "holder_name": "John Doe"
   },
   "virtual_account_number": "1450800030135932727Z44",
   "descriptions": [
      "Invoice 1234"
   ],
   "reconciled_amount": 12000,
   "reconciliation_status": "reconciled",
   "metadata": {},
   "custom_fields": {},
   "canceled_at": null,
   "updated_at": "2023-01-06T14:32:49.180422Z",
   "created_at": "2023-01-03T08:51:13.958195Z"
}