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 Asynchronous API

Asynchronous API for submitting long-running operations and retrieving their results without blocking, complementing the synchronous Assembly API. OpenAPI 3.0.0, version 1.0.0, 3 documented paths, supporting OAuth2 client-credentials and basic authentication.

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

Tagged areas include Async, Batch, and Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 3 operations across 3 paths, organized into 2 resource areas, and defines 8 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against 3 base URLs: https://virtserver.swaggerhub.com/AssemblyPlatforms/assembly-async-api/1.0.0, https://test.tnq.api.assemblypay.com/, https://tnq.api.assemblypay.com/.

3 operations 3 paths 8 schemas 2 GET1 PATCH

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://tnq.api.assemblypay.com/
Authentication
HTTP Basic, OAuth 2.0
Resource Areas
2

Authentication & Security 2

Zai Asynchronous API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (basicAuth). It supports OAuth 2.0 (oAuth2ClientCredentials) using the clientCredentials flow. By default, every request must be authenticated.

  • oAuth2ClientCredentials — Please refer to Authentication section within https://developer.assemblypayments.com/referenceauthentication

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 PATCH. They span 2 resource areas: Item Actions, Requests. Each is listed below with its method, path, parameters, and response codes.

Item Actions 1
PATCH
/items/{id}/make_payment
Make Payment
1 param body → 200202400401409503
Requests 2
GET
/request/{request_id}/status
Get Request Status
1 param → 200202401503
GET
/request/{request_id}/callbacks
Get Request Callback Details
1 param → 200401503

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are item (46 properties), make_payment_requestBody (5 properties), status (4 properties), callback (3 properties). Each schema is shown below with its type and property counts.

single_item
object
1 property
items
object
3 properties
item
object
46 properties
links
object
2 properties
status
object
4 properties
callbacks
object
2 properties
callback
object
3 properties
make_payment_requestBody
object
5 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zai-async-api.json Raw ↑

Other APIs Zai publishes across the network.

Zai Assembly API
Zai Virtual Accounts and PayIDs API
Zai PayTo API