The Payments endpoint holds real-time records of any attempted payment in the Pay Advantage system. It is used for monitoring and tracking payments so that they can be managed appropriately by your own system. The Payments endpoint does not allow re-attempting failed payments.
All payments are associated with either a Customer, or a Debit Instruction. When a payment is attempted PayAdvantage allows a small window for any failures to be reported (typically 2-3 business days). This is due the processing times of some banks and credit card facilities. If no failure has been reported within this window then it is considered cleared and will then be settled to your account. BPAY payments are the only exception as they clear/settle immediately. View information on Payment clearing and settlement.
All payment types can fail (for a number of reasons) in which case the DateFailed and FailCode fields will be populated. Be aware that a payment can fail after the money has been settled to your account. This could occur many days, months, even years after settlement. Due to the nature of banking services and always allowing for payments to fail or be charged back, It is more correct to consider a payment as not failed rather than succeeded; however for most scenarios you can consider a settled payment as a success,. Charge-backs and late dishonours are rare for most businesses.
Returns a single payment record using the reference code value of a payment as an identifier.
This lets you view the current status of a payment, a history of the payments progression through different states (paid, failed, cleared, settled, etc.), any reason for failure, amount, payment type, any other relevant references.