Integration Guide Overview
We've broken down these guides into the following pages to help lead you through Zepto's PayTo solution. In addition to our articles, you can head on over to our API Docs to experiment and explore further:
For additional information regarding Zepto's configuration guides, you can head over to the link below:
1. Welcome |
Welcome
Welcome to Zepto's PayTo API - we're happy to have you aboard. These guides aim to give you a view into what's coming and enable your teams to start forming your payment flows around our PayTo solution.
As well as delivering our scalable, best-in-class PayTo solution, we've become the NPPA's first Connected Institution. Meaning that, we've connected to the global SWIFT network and built out our own banking-grade infrastructure that connects directly to the NPPAโโs Basic Infrastructure (NPP).
This has been no easy feat. The arduous journey to becoming a Connected Institution has, and will continue to unlock a host of benefits such as ensuring the exponential scaling of all of our partners as well as having a seat at the table alongside the 13 Fully Connected NPPA/AP+ partners. Being a Connected Institution means having a direct influence on the direction of the new NPP services, no intermediaries, direct & faster connectivity, and generally being the masters of our own destiny... We are super proud of this achievement, and excited for what comes next ๐
As the broader industry rolls out and adopts PayTo, Zepto will continue to iterate on our PayTo offering to ensure weโre delivering a world-class experience. As such, please be aware that we may make small changes to our API moving forward.
PayTo
PayTo (formally known as the Mandated Payments Service or MPS) is the biggest shake-up in account-to-account payments in Australian history. To date, the only way to pull funds from a bank account has been to perform a direct debit via the antiquated BECS system. This system essentially passes batch payment files between Tier 1 banks, 6 times a day, Monday to Friday, takes a break at the weekends, hates working public holidays, and makes it a real pain to receive funds given a payment takes 2 days to clear - and even then, can still, sometimes fail.
Enter the NPPA's PayTo ๐
To find out more about PayTo, please check out the following resources:
PayTo Availability
PayTo continues to be rolled out across the industry, with a significant number of accounts already online. For greater clarity on PayTo availability across specific accounts, please check with the respective financial institutions that are offering these services.
Type | Availability |
Retail Accounts | A majority of customer accounts are now live |
Business Accounts | 2024 |
PayTo Concepts
Whether you are new to Zepto or are already using our highly composable API for your payment flows, we've learned a lot over the years and have made a few tactical decisions around our PayTo APIs to enable all our platforms to scale safely.
Asynchronous Operations
Our API is designed to be asynchronous to maintain consistently fast response times:
Invalid requests:
Invalid schema will be rejected immediately (400 Bad Request)
Failed field validations will be rejected immediately (422 Unprocessable Entity) with relevant error messages
Valid requests:
receive
201 Created
with a ref id that can be used to track the resource
Synchronous Notifications
There are two ways to determine the outcome of your request. Depending on your integration, you can choose your preferred method:
Webhooks: Each outcome will fire a webhook to notify your application in real-time of the result
Polling: In the event an outcome needs to be checked out-of-band, the resource may be queried directly
Alternatively, combine both webhooks and polling to meet your notification needs.
Idempotency
Include your own unique 64-character payment id to enforce idempotent behaviour throughout the application.
This id is required when requesting a new:
PayTo Agreement
PayTo Payment
Glossary
Common Abbreviations | Descriptions |
AP+ | |
BECS | Bulk Electronic Clearing System |
Bilateral actions | Where an Agreement action requires authorisation from the other party |
BBAN | Basic Bank Account Number |
BI | Basic Infrastructure |
CI | Connected Institution |
Creditor | The party to whom money is owing. |
Debtor | The party that owes money. |
FI | Financial Institution |
Initiator | The merchant or third party processor (TTP), if applicable. |
Mandate | The informal name for a PayTo Agreement |
NPP | New Payments Platform |
NPPA | New Payments Platform Australia |
Payee | The party that is receiving funds. |
Payer | The party that is sending funds. |
OFI | Other Financial Institution |
Unilateral actions | Where an Agreement action does not require the authorisation from the other party |