Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zai Virtual Accounts and PayIDs API

Create and manage Virtual Accounts and PayIDs on the New Payments Platform (NPP), letting platforms receive real-time account-to-account pay-ins to uniquely addressable virtual accounts. OpenAPI 3.0.0, version 0.12-external, 8 documented paths on the assemblypay.com host.

Zai Virtual Accounts and PayIDs API is one of 4 APIs that Zai publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include PayID, Virtual Accounts, NPP, and Real-Time Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 9 operations across 8 paths, organized into 2 resource areas, and defines 28 schemas. It is described by OpenAPI 3.0.0, at version 0.12-external.

Requests are made against 2 base URLs: https://sandbox.au-0000.api.assemblypay.com, https://au-0000.api.assemblypay.com.

9 operations 8 paths 28 schemas 3 GET4 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
0.12-external
Base URL
https://au-0000.api.assemblypay.com
Resource Areas
2

Paths & Operations 9

Across 8 paths, the API surfaces 9 operations — 3 GET, 4 PATCH, 2 POST. They span 2 resource areas: Virtual Accounts, PayIDs. Each is listed below with its method, path, parameters, and response codes.

Virtual Accounts 6
POST
/wallet_accounts/{id}/virtual_accounts
Create Virtual Account
createVirtualAccount 1 param body → 202400401403404409500
GET
/wallet_accounts/{id}/virtual_accounts
List Virtual Accounts
listVirtualAccountByWalletAccount 1 param → 200400401403404500
GET
/virtual_accounts/{id}
Show Virtual Account
showVirtualAccount 1 param → 200400401403404500
PATCH
/virtual_accounts/{id}/aka_names
Update AKA Names
updateVirtualAccountAKAName 1 param body → 202400401403404500409
PATCH
/virtual_accounts/{id}/account_name
Update Account Name
updateVirtualAccountAccountName 1 param body → 202400401403404500409
PATCH
/virtual_accounts/{id}/status
Update Virtual Account Status
updateVirtualAccount 1 param body → 202400401403404409500
PayIDs 3
POST
/virtual_accounts/{id}/pay_ids
Register PayID
registerPayID 1 param body → 202400401403404409500
PATCH
/pay_ids/{id}/status
Update PayID Status
updatePayIdStatus 1 param body → 202400401403404409500
GET
/pay_ids/{id}
Retrieve a PayID
getPayID 1 param → 200400401403404500

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are virtual_account (14 properties), pay_id (8 properties), deregister_pay_id (3 properties), pay_id_request (3 properties). Each schema is shown below with its type and property counts.

virtual_account
object
14 properties
create_virtual_account_request
object
2 properties
virtual_account_account_name
string
A name given for a Virtual Account. This is used in CoP lookups.
merchant_id
string
An identifier that links a Virtual Account to a merchant. This is used in CoP lookups.
aka_names
array
A list of AKA Names.
aka_name
string
An alias for a Virtual Account. This is used in CoP lookups.
update_virtual_account_aka_names_request
object
1 property 1 required
update_virtual_account_account_name_request
object
1 property 1 required
virtual_accounts_list
object
2 properties
pay_id_request
object
3 properties 3 required
pay_id
object
8 properties
deregister_pay_id
object
3 properties
inline_response_400_deprecated
object
1 property
inline_response_400
object
1 property
inline_response_400_1
object
1 property
inline_response_401
object
1 property
inline_response_403_inactive
object
1 property
inline_response_403_va
object
1 property
inline_response_403_pay_id
object
1 property
inline_response_404_pay_id
object
1 property
wallet_account_not_found
object
1 property
inline_response_409
object
1 property
inline_response_409_patch
object
1 property
inline_response_409_object
object
1 property
inline_response_409_1
object
1 property
inline_response_500
object
1 property
virtual_account_not_found
object
1 property
update_va_status_resp
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zai-virtual-accounts-payid.json Raw ↑

Other APIs Zai publishes across the network.

Zai Assembly API
Zai PayTo API
Zai Asynchronous API