Documents
Documents and downloads
Contract files, sandbox data, workflow diagrams and partnership documents for the A2A InstaPay Tenant API v1.1.
Developer documentation#
Always current, and the place to start.
| Documentation Guides from the first call to go-live, for consumers and merchants. | Web |
| API reference Every endpoint, field, error code and object, generated from the contract. | Web |
| Webhook events All 27 events with examples, delivery rules and signatures. | Web |
| Test data Values that always produce the same outcome. | Web |
Contract files#
The machine-readable contract of the Tenant API v1.1, for API tools, code generators and automated tests.
| OpenAPI 3.1 contract (YAML) The Tenant API v1.1 with webhook definitions. | YAML 217 KB |
| OpenAPI 3.1 contract (JSON) The same contract in JSON. | JSON 248 KB |
| Webhook event examples One example of each of the 27 webhook events. | JSON 24 KB |
| Postman collection Every operation, with a request that stores the access token. | JSON |
Sandbox data#
What you need to test: addresses, test values and how the sandbox differs from production.
| Sandbox data sheet Addresses, security policy domains, test identities, banks, amounts and codes. Printable. | Web, printable |
| Test values (JSON) The test values in a machine-readable file for automated tests. | JSON |
| Sandbox and production differences (JSON) What is simulated and what changes in production. | JSON |
| Documentation index for coding assistants A plain-text index of the contract, test data and SDK (llms.txt). | Text |
Workflow diagrams#
The state machines of the records and flows of the Tenant API.
| State machine diagrams 16 diagrams: onboarding, bank linking, hosted sessions, loads, payments, QR payment requests, withdrawals, refunds, disputes and webhooks. | Web, SVG |
Partnership documents#
Confidential documents for Tenants and prospective Tenants. They are shared through a secure channel, under the confidentiality terms agreed with FINAP USA LLC.
| A2A InstaPay PaaS Tenant Integration Specification v1.0 The partnership model, roles, workflows, compliance obligations, account structures and the go-live process. Word. | Request a copy |
| A2A InstaPay Tenant API Reference v1.1 The contract as a document, including the web app (WAP) procedure. Word, with the OpenAPI file and webhook examples. | Request a copy |
Terms and policies#
The terms that apply to the use of the sandbox.
| Sandbox terms of use The terms for using the A2A InstaPay Sandbox. | Web |
| Privacy notice How the sandbox handles the information you give it. | Web |
| Acceptable use What the sandbox may and may not be used for. | Web |