Receive Payments
PayTo
mpayto allows you to debit an enabled domestic bank account in real time monoova's payto api supports synchronous and asynchronous operations, allowing flexible integration based on varying business needs the asynchronous api option is particularly beneficial for handling batch operations requiring extended processing time, enhancing overall system performance and reliability additionally, monoova provides webhook subscriptions, enabling users to receive timely updates and notifications about transaction events, which helps maintain transparency and control over financial activities generate a bearer token generate a bearer token docid 1diwgksbes6vrealmz c4 to access the payto api the bearer token is active for 24 hours and must be regenerated once it expires create an agreement create a payment agreement docid\ isybadzfpyzmkydo cy8n the payer will be able to view and authorise the agreement through their banking app the terms of the agreement determine the amount and schedule of allowed debits when you create a payment agreement, the account is validated in real time, so you can ensure the account details are correct initiate a payment use the create payment instruction docid\ s nmkgpor gkvrjtbfexw endpoint to debit money from an account once the agreement has been accepted by the payer if successful, funds will be credited to the payee account in real time and made available for disbursement because recipients can access funds faster than traditional direct debit systems, this is particularly beneficial for businesses or individuals relying on prompt cash flow payments subscribe to notifications monoova uses webhooks to provides updates on the status of payment agreements and payment instructions, which can be subscribed to using the create a subscription docid\ ixk3xlaqxc6oralijiw d endpoint event event name when a payer makes a change to a payment agreement (for example authorising or cancelling a payment agreement through their banking app) paymentagreementnotification when the status of a submitted payment instruction changes, such as when the payment is accepted and settled, or when it declines paymentinstructionnotification when the status of an asynchronous request changes this is used in conjunction with the asynchronous payto endpoints asyncjobresultnotification manage agreements payto allows agreements to be amended once active depending on the changes to the agreement, payer approval may or may not be required unilateral amendment docid 9 gpzya kdwofjciavuox to a payment agreement can be done without the payer’s approval the only fields that can be changed unilaterally are the payee object and agreement descriptions when a unilateral amendment is submitted the changes are made immediately bilateral amendment docid\ w8kv1nu 3i2gfn3r l2io are changes to the agreement terms that require the payer’s approval changes made using this end point will only get reflected after payer approves the change until the new terms are approved, the payment agreement will remain active with its last approved terms you can also amend payment agreement status docid\ fmjbdztrmhb9dyc4yo nf or recall a payment agreement docid 320xsqij4h2uwb nj30z0 if it hasn't been accepted by the customer yet asynchronous processing monoova also offers a suite of asynchronous payto endpoints, which have a much higher rate limit than their synchronous counterparts and can be used in scenarios where agreements or payments are less time critical asynchronous request are added to a queue and are processed when resources are available