> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kashimi.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Detailed Status Reference

> Complete reference for all detailedStatus values, grouped by payment lifecycle phase.

The `detailedStatus` field provides granular insight into exactly where a payment sits within its lifecycle. Every `detailedStatus` maps to one of three top-level `status` values.

| Top-level `status` | Meaning                                                                      |
| ------------------ | ---------------------------------------------------------------------------- |
| `PENDING`          | The payment is progressing normally — an action or response is in progress.  |
| `FAILED`           | A step in the flow could not be completed. See `failureReasons` for details. |
| `COMPLETED`        | The payment has been successfully processed by the bank.                     |

<Info>
  Not every status will appear for every payment. Which phases are traversed depends on the selected bank, the integration type (Custom Bank Selection vs Hosted), and whether the bank requires account information consent or sender account selection.
</Info>

***

## Retrieving status history

Use [GET /api/v1/archive/payment-statuses](/api-reference/endpoint/paymentStatuses) to retrieve the complete chronological history of status changes for a payment. Unlike the [latest status endpoint](/api-reference/endpoint/latestPaymentStatus), this returns an **array** of every status event recorded, ordered from earliest to most recent.

```http theme={null}
GET /api/v1/archive/payment-statuses?paymentId={paymentId}
```

**Example response:**

```json theme={null}
[
  {
    "id": "a1b2c3d4-0001-0000-0000-000000000000",
    "paymentId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "PENDING",
    "detailedStatus": "PAYMENT_CONSENT_REDIRECT_PENDING",
    "failureReasons": null,
    "createdAt": "2026-04-28T10:00:00.000Z"
  },
  {
    "id": "a1b2c3d4-0002-0000-0000-000000000000",
    "paymentId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "PENDING",
    "detailedStatus": "PAYMENT_CONSENT_CALLBACK_PROCESSING_PENDING",
    "failureReasons": null,
    "createdAt": "2026-04-28T10:01:14.000Z"
  },
  {
    "id": "a1b2c3d4-0003-0000-0000-000000000000",
    "paymentId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "PENDING",
    "detailedStatus": "PAYMENT_EXECUTION_PENDING",
    "failureReasons": null,
    "createdAt": "2026-04-28T10:01:17.000Z"
  },
  {
    "id": "a1b2c3d4-0004-0000-0000-000000000000",
    "paymentId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "COMPLETED",
    "detailedStatus": "PAYMENT_EXECUTION_COMPLETED",
    "failureReasons": null,
    "createdAt": "2026-04-28T10:01:22.000Z"
  }
]
```

Use this endpoint to audit the full lifecycle of a payment, debug unexpected outcomes, or display a status timeline to the PSU.

***

## Phase 1 — Provider Selection

*Hosted Bank Selection flow only.* Kashimi displays its own bank selection screen. The PSU selects their bank and Kashimi processes the choice before continuing.

| `detailedStatus`                                 | Description                                                                                   | `status`                              |
| ------------------------------------------------ | --------------------------------------------------------------------------------------------- | ------------------------------------- |
| `PROVIDER_SELECTION_REDIRECT_PENDING`            | The PSU is being redirected to Kashimi's hosted bank selection screen.                        | <Badge color="yellow">PENDING</Badge> |
| `PROVIDER_SELECTION_CALLBACK_PROCESSING_PENDING` | The PSU has selected a bank. Kashimi is processing the selection and preparing the next step. | <Badge color="yellow">PENDING</Badge> |

***

## Phase 2 — Follow-up Data Collection

Some banks require additional PSU data before the payment flow can continue — for example, a customer ID or a specific account number. This phase collects that data.

| `detailedStatus`                                       | Description                                                                      | `status`                              |
| ------------------------------------------------------ | -------------------------------------------------------------------------------- | ------------------------------------- |
| `FOLLOWUP_DATA_COLLECTION_REQUIRED_CHECK_PENDING`      | Kashimi is determining whether additional data is required by the selected bank. | <Badge color="yellow">PENDING</Badge> |
| `FOLLOWUP_DATA_COLLECTION_REDIRECT_PENDING`            | The PSU is being redirected to provide the required additional data.             | <Badge color="yellow">PENDING</Badge> |
| `FOLLOWUP_DATA_COLLECTION_CALLBACK_PROCESSING_PENDING` | The PSU has submitted the required data. Kashimi is processing the response.     | <Badge color="yellow">PENDING</Badge> |
| `FOLLOWUP_DATA_COLLECTION_CALLBACK_PROCESSING_FAILED`  | The follow-up data collection step failed — the response could not be processed. | <Badge color="red">FAILED</Badge>     |

***

## Phase 3 — Sender Authorization

The PSU grants Kashimi authorisation to act on their behalf at the bank. This establishes the identity and access context required for subsequent steps.

| `detailedStatus`                                   | Description                                                                         | `status`                              |
| -------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------- |
| `SENDER_AUTHORIZATION_REQUIRED_CHECK_PENDING`      | Kashimi is checking whether sender authorisation is required for the selected bank. | <Badge color="yellow">PENDING</Badge> |
| `SENDER_AUTHORIZATION_REDIRECT_PENDING`            | The PSU is being redirected to their bank to grant authorisation.                   | <Badge color="yellow">PENDING</Badge> |
| `SENDER_AUTHORIZATION_REDIRECT_FAILED`             | The redirect to the bank for sender authorisation could not be initiated.           | <Badge color="red">FAILED</Badge>     |
| `SENDER_AUTHORIZATION_CALLBACK_PROCESSING_PENDING` | The PSU has returned from the bank. Kashimi is processing the authorisation result. | <Badge color="yellow">PENDING</Badge> |
| `SENDER_AUTHORIZATION_CALLBACK_PROCESSING_FAILED`  | The authorisation callback from the bank could not be processed.                    | <Badge color="red">FAILED</Badge>     |

***

## Phase 4 — Sender Account

Kashimi resolves the PSU's sending account. Depending on the bank, this may involve obtaining account information consent, retrieving the account list, and prompting the PSU to select the account to pay from.

| `detailedStatus`                                                 | Description                                                                                | `status`                              |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------- |
| `SENDER_ACCOUNT_REQUIRED_CHECK_PENDING`                          | Kashimi is checking whether sender account resolution is required for this payment.        | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_INFORMATION_CONSENT_REQUIRED_CHECK_PENDING`      | Kashimi is checking whether account information consent is required by the bank.           | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_INFORMATION_CONSENT_REDIRECT_PENDING`            | The PSU is being redirected to their bank to grant account information consent.            | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_INFORMATION_CONSENT_REDIRECT_FAILED`             | The redirect for account information consent could not be initiated.                       | <Badge color="red">FAILED</Badge>     |
| `SENDER_ACCOUNT_INFORMATION_CONSENT_CALLBACK_PROCESSING_PENDING` | The PSU has returned from the bank. Kashimi is processing the account information consent. | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_INFORMATION_CONSENT_CALLBACK_PROCESSING_FAILED`  | Processing the account information consent callback failed.                                | <Badge color="red">FAILED</Badge>     |
| `SENDER_ACCOUNT_LIST_RETRIEVAL_PENDING`                          | Kashimi is retrieving the PSU's account list from the bank using the granted consent.      | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_LIST_RETRIEVAL_FAILED`                           | The account list could not be retrieved from the bank.                                     | <Badge color="red">FAILED</Badge>     |
| `SENDER_ACCOUNT_SELECTION_REQUIRED_CHECK_PENDING`                | Kashimi is checking whether the PSU needs to select a specific sending account.            | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_SELECTION_REQUIRED_CHECK_FAILED`                 | The check for whether account selection is required could not be completed.                | <Badge color="red">FAILED</Badge>     |
| `SENDER_ACCOUNT_SELECTION_REDIRECT_PENDING`                      | The PSU is being redirected to select their sending account.                               | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_SELECTION_REDIRECT_FAILED`                       | The redirect for account selection could not be initiated.                                 | <Badge color="red">FAILED</Badge>     |
| `SENDER_ACCOUNT_SELECTION_CALLBACK_PROCESSING_PENDING`           | The PSU has selected an account. Kashimi is processing the selection.                      | <Badge color="yellow">PENDING</Badge> |
| `SENDER_ACCOUNT_SELECTION_CALLBACK_PROCESSING_FAILED`            | Processing the account selection callback failed.                                          | <Badge color="red">FAILED</Badge>     |

***

## Phase 5 — Payment Registration

Kashimi registers the payment request with the bank before seeking the PSU's payment authorisation.

| `detailedStatus`               | Description                                        | `status`                              |
| ------------------------------ | -------------------------------------------------- | ------------------------------------- |
| `PAYMENT_REGISTRATION_PENDING` | Kashimi is registering the payment with the bank.  | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_REGISTRATION_FAILED`  | The payment could not be registered with the bank. | <Badge color="red">FAILED</Badge>     |

***

## Phase 6 — Payment Consent

The PSU reviews and authorises the payment at their bank. Some banks first require the PSU to choose their preferred authentication method (e.g. mobile app, SMS OTP, token device) before proceeding to authorise the payment.

| `detailedStatus`                                                              | Description                                                                                              | `status`                              |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| `PAYMENT_CONSENT_REQUIRED_CHECK_PENDING`                                      | Kashimi is checking the payment consent requirements for this bank.                                      | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_REQUIRED_CHECK_PENDING`      | Kashimi is checking whether the PSU must select an authentication method before authorising the payment. | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_REQUIRED_CHECK_FAILED`       | The check for authentication method selection requirement failed.                                        | <Badge color="red">FAILED</Badge>     |
| `PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_REDIRECT_PENDING`            | The PSU is being redirected to select their preferred authentication method.                             | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_CALLBACK_PROCESSING_PENDING` | The PSU has selected an authentication method. Kashimi is processing the selection.                      | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_CALLBACK_PROCESSING_FAILED`  | Processing the authentication method selection callback failed.                                          | <Badge color="red">FAILED</Badge>     |
| `PAYMENT_CONSENT_REDIRECT_PENDING`                                            | The PSU is being redirected to their bank to review and authorise the payment.                           | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_CONSENT_REDIRECT_FAILED`                                             | The redirect for payment authorisation could not be initiated.                                           | <Badge color="red">FAILED</Badge>     |
| `PAYMENT_CONSENT_CALLBACK_PROCESSING_PENDING`                                 | The PSU has returned from the bank. Kashimi is processing the authorisation outcome.                     | <Badge color="yellow">PENDING</Badge> |
| `PAYMENT_CONSENT_CALLBACK_PROCESSING_FAILED`                                  | Processing the payment consent callback failed.                                                          | <Badge color="red">FAILED</Badge>     |

***

## Phase 7 — Payment Execution

The bank processes the authorised payment and settles the funds.

| `detailedStatus`              | Description                                                               | `status`                               |
| ----------------------------- | ------------------------------------------------------------------------- | -------------------------------------- |
| `PAYMENT_EXECUTION_PENDING`   | The payment has been authorised and submitted to the bank for processing. | <Badge color="yellow">PENDING</Badge>  |
| `PAYMENT_EXECUTION_FAILED`    | The bank was unable to process or settle the payment.                     | <Badge color="red">FAILED</Badge>      |
| `PAYMENT_EXECUTION_COMPLETED` | The payment was successfully processed and settled by the bank.           | <Badge color="green">COMPLETED</Badge> |