Implementing PayTo

payto is not enabled by default in sandbox please contact monoova to enable this feature on your sandbox account setting up a payto agreement is simple first, you create a payment agreement docid\ isybadzfpyzmkydo cy8n between a payer and payee 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 next, the payer approves the agreement through their banking app before it expires finally, you can create payment instruction docid\ s nmkgpor gkvrjtbfexw if successful, funds will be credited to your account in real time 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 creating an agreement an agreement between yourself and the payer is required before you can debit their account this agreement sets out the terms of payment, including the frequency, dates, and amounts that will be debited payers will need to authorise the agreement through their online banking or bank app before you can send a payment initiation adding payto as an option to your application or checkout is simple; customers can be prompted to select it as a payment method where multiple payment options are available customers can choose to supply their payid or bsb & account number; these will be validated when creating the agreement, and debited when a payment initiation is created use this information to populate a post call to create a payment agreement docid\ isybadzfpyzmkydo cy8n once a call has been made to this endpoint, the customer will automatically receive the agreement information in their online banking to accept serving information on how customers can accept their agreement on your ui can increase authorisation rates once the customer has accepted the agreement, you’ll receive a webhook advising the agreement is approved you can use this webhook to update the ui with a success or failure message to reinforce that the agreement has been set up subscribe to the paymentagreementnotification event to receive this notification this webhook returns the status of an agreement when it’s approved, declined, expired, or cancelled initiating a payment once the payer has approved an agreement you can initiate a payment by calling the create payment instruction docid\ s nmkgpor gkvrjtbfexw endpoint this endpoint takes the agreement id and the payment amount and validates it against the agreement if this payment matches the agreement terms it will be debited from the payers account in real time subscribing to the paytoreceivepayment webhook event will allow you to see when payment is settled to your account payments can be settled to your monoova maccount, a ledger account, or directly to your external bank account refunding a payment to refund a payment, pass the payment instruction id or agreement id to the /receivables/v2/refund docid\ tsgzt7ctl0cqjptvrppha endpoint