Get Transfer Status
Get Transfer Status
The Get Transfer Status services is used to retrieve the status of a single or batch transfer initiated through the API. The service returns the current transfer status.
Endpoints
GET /bab/v1/transfers/single/{transferId}/status
GET /bab/v1/transfers/batch/{batchId}/status
Path Parameters
| Endpoint | Path Parameter | Description |
|---|---|---|
| /bab/v1/transfers/single/{transferId}/status | transferId | Internal Id of the single transfer |
| /bab/v1/transfers/batch/{batchId}/status | batchId | Internal Id of the batch transfer |
Response Parameters
| Field | Type | Description |
|---|---|---|
| status | string | Overall status of the transfer or batch |
| singleTransferData | object / TransferStatusData | Single transfer status data |
| batchTransferData | array / TransferStatusData | List of statuses of orders included in the batch |
TransferStatusData object
| Field | Type | Description |
|---|---|---|
| position | integer | Order position provided in the request |
| transferId | string | transfer/payment Id assigned in the bank's system |
| transferStatus | string | Status of the specific order |
| errorDetailEN | string / null | Error details in English |
| errorDetailGE | string / null | Error details in Georgian |
| failureReasonEn | string / null | Failure reason in English |
| failureReasonGe | string / null | Failure reason in Georgian |
The errorDetailEN, errorDetailGE, failureReasonEn and failureReasonGe fields are populated when transfer processing cannot be completed or when an upstream system returns additional error/failure information.
Single Transfer Status
| Single transfer status | Description |
|---|---|
| Initial state | Transfer is created in the initial state |
| Draft | Transfer is saved as a draft |
| Registered | Transfer is registered |
| Deleted | Transfer is deleted |
| Waiting for certification | Transfer is awaiting authorization / confirmation |
| In progress | In progress |
| Error | An error occurred |
| Finished | Completed |
| Failed | Failed |
| Cancelled | Cancelled |
Batch Transfer Status
| Batch transfer statuss | Description |
|---|---|
| Uploading | Batch upload / import is in progress |
| Registered | Batch is registered |
| Waiting for certification | Batch is awaiting authorization / confirmation |
| In progress | In progress |
| Finished | Batch processing is completed |
| Finished with errors | Completed, but an error occurred for one or more orders |
| Failed | Failed |
| Cancelled | Cancelled |
| Error | An error occurred |
Request / Response Examples
Single Transfer Example: GET /bab/v1/transfers/single/502341/status
Batch Transfer Example: GET /bab/v1/transfers/batch/184729/status
{
"status": "Completed",
"singleTransferData": {
"position": 1,
"transferId": "502341",
"transferStatus": "Completed"
},
"batchTransferData": [
{
"position": 1,
"transferId": "502341",
"transferStatus": "Completed"
}
]
}