Expected payments

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 a transaction.

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

Attribute

Description

id
string

The UUID of the expected payment.

object
string

The object, here expected_payment.

connected_account
string

The ID of the connected account related to the payment.

direction
string

Either credit or debit.

Direction is credit when you expect to receive money, while it is debit when you expect to send money.

amount_from
integer

The absolute value of the payment in the specified currency's smallest unit.

If the amount of the payment is uncertain, you can specified the lowest amount you could expect in amount_from.

If the exact amount of the payment is known with certainty, the same amount can be specified in `amount_fromandamount_to``.

amount_to
integer

The absolute value of the payment in the specified currency's smallest unit.

If the amount of the payment is uncertain, you can specified the highest amount you could expect in amount_to.

If the exact amount of the payment is known with certainty, the same amount can be specified in `amount_fromandamount_to``.

currency
integer

The currency of the payment.

start_date
date

The expected date of the payment.

If the date of the payment is uncertain, you can specified the earliest date in start_date.

If the exact date of the payment is known with certainty, the same date can be specified in start_date and end_date.

end_date
date

The expected date of the payment.

If the date of the payment is uncertain, you can specified the earliest date in start_date.

If the exact date of the payment is known with certainty, the same date can be specified in start_date and end_date.

counterparty_account_details
object

The account of the counterparty, which is either the debitor or the creditor depending on the payment's direction.

The object includes the following attributes:
account_number: the account number of the counterparty, which can be the IBAN or any other identification provided by the bank
holder_name: the name of the counterparty

description
string

The description of the expected_payment.

metadata
array

Additional data in JSON key:value format. See Metadata.

reconciliation_status
string

The reconciliation status of the transaction, which is either unreconciled, reconciled, or partially_reconciled.

reconciled_amount
integer

The amount of the expected payment that is already reconciled.

It is the sum of the amount of the reconciliations related to this expected payment.

canceled_at
date

The UTC timestamp of the cancellation of this expected payment. canceled_at is null if the expected payment was not canceled.

created_at
date

The UTC timestamp of the creation of the expected payment.

updated_at
date

The UTC timestamp of the last update of the expected payment.

Below is an example of an expected_payment :

{
   "id":"fdff5955-fb30-4827-993d-3841016e8246",
   "object": "expected_payment",
   "direction": "credit",
   "amount": 12000,
   "currency": "EUR",
   "start_date": "2022-01-05",
   "end_date": "2022-01-10",
   "connected_account_id": "a55e3ac4-6956-422f-be98-aa7374482f7c",
   "counterparty_account_details": {
      "account_number": "",
      "holder_name": ""
   },
   "description": "Invoice 1234",
   "metadata": {},
   "reconciled_amount": 12000,
   "reconciliation_status": "reconciled",
   "created_at": "2022-01-03",
   "canceled_at": null
}