The following codes are used in the status field to provide information about the logical result of a specific API call. Status codes provide additional information with respect to HTTP response codes: for example, an HTTP/1.1 200 (OK) response code may still contain a KO status code to indicate that the call was successful on the protocol layer, but it actually failed from the business logic perspective.
OKThe operation was successful. Thepayloadresponse element may provide additional response data.KOThe operation failed. Theerrororerrorsresponse element may provide additional information about the occurred error.PENDINGThe operation requires additional information to be executed (for example, the response to an authorization challenge).
The following table provides a quick reference to the supported status codes in each API version.
| API Version | OK Status |
KO Status |
PENDING Status |
| 1.0 | YES | YES | NO |
| 2.0 | YES | YES | YES |
| 2.1 | YES | YES | YES |
| 3.0 | YES | YES | YES |
| 4.0 | YES | YES | YES |