Async Requests

Some service requests (/inquiry/ / /fees_inquiry/ / /payment/) require a long time to be processed (more than 60 seconds at some cases). In order to handle this without timeouts, these request are performed asynchronously.

Response

Async responses return with this format

{
  "code": "0003",
  "request_id": "9c0ea1eb-fe75-4b0a-82dd-15ad5a3f51bf",
  "async_topic": "875fbbcb-9d55-449e-9094-65e97418a927"
}

Response Description

Field Type Description
code String 0003 is the default response code for async response
request_id String Unique request id
async_topic String Unique async topic on which the client will receive the async response

Pushy

Response is then published on Pushy* over the topic async_topic returned in the response having the default payload of the default response, along with the key status_code in the message headers containing the response. Client should listen on the async_topic once they receive a response 0003 in order to retrieve the response. This should not impact the user experience, it may only lead to a longer wait time till the response is received.

* Pushy API Key is shared privately with the client upon integration.