Skip to main content
GET
/
api
/
v1
/
archive
/
payment-statuses
/
latest
cURL
curl --location --request GET "https://api.kashimi.tech/api/v1/archive/payment-statuses/latest?paymentId=123e4567-e89b-12d3-a456-426614174000"
--header "Accept: application/json"
--header "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "id": "e68eee70-bfe9-4885-8650-46ec7d017458",
  "paymentId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "PENDING",
  "detailedStatus": "PAYMENT_CONSENT_CALLBACK_PROCESSING_PENDING",
  "failureReasons": [
    "AMOUNT_EXCEEDS_AVAILABLE_FUNDS"
  ],
  "createdAt": "2023-10-01T12:00:00Z"
}

Headers

​
Authorization
string
required

Bearer token for authentication

Query Parameters

​
paymentId
string
required

Kashimi payment ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Response

Returns the latest payment status for the given payment ID

​
id
string
required

Unique payment status identifier

Example:

"e68eee70-bfe9-4885-8650-46ec7d017458"

​
paymentId
string
required

Unique payment identifier

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
enum<string>
required

Payment status. There are 3 main values: PENDING, COMPLETED, FAILED. In very rare cases, caused by internal system issues, the status might resolve to UNKNOWN

Available options:
PENDING,
COMPLETED,
FAILED,
UNKNOWN
Example:

"PENDING"

​
detailedStatus
enum<string>
required

Detailed payment status

Available options:
PROVIDER_SELECTION_REDIRECT_PENDING,
PROVIDER_SELECTION_CALLBACK_PROCESSING_PENDING,
FOLLOWUP_DATA_COLLECTION_REQUIRED_CHECK_PENDING,
FOLLOWUP_DATA_COLLECTION_REDIRECT_PENDING,
FOLLOWUP_DATA_COLLECTION_CALLBACK_PROCESSING_PENDING,
FOLLOWUP_DATA_COLLECTION_CALLBACK_PROCESSING_FAILED,
SENDER_AUTHORIZATION_REQUIRED_CHECK_PENDING,
SENDER_AUTHORIZATION_REDIRECT_PENDING,
SENDER_AUTHORIZATION_REDIRECT_FAILED,
SENDER_AUTHORIZATION_CALLBACK_PROCESSING_PENDING,
SENDER_AUTHORIZATION_CALLBACK_PROCESSING_FAILED,
SENDER_ACCOUNT_REQUIRED_CHECK_PENDING,
SENDER_ACCOUNT_INFORMATION_CONSENT_REQUIRED_CHECK_PENDING,
SENDER_ACCOUNT_INFORMATION_CONSENT_REDIRECT_PENDING,
SENDER_ACCOUNT_INFORMATION_CONSENT_REDIRECT_FAILED,
SENDER_ACCOUNT_INFORMATION_CONSENT_CALLBACK_PROCESSING_PENDING,
SENDER_ACCOUNT_INFORMATION_CONSENT_CALLBACK_PROCESSING_FAILED,
SENDER_ACCOUNT_LIST_RETRIEVAL_PENDING,
SENDER_ACCOUNT_LIST_RETRIEVAL_FAILED,
SENDER_ACCOUNT_SELECTION_REQUIRED_CHECK_PENDING,
SENDER_ACCOUNT_SELECTION_REQUIRED_CHECK_FAILED,
SENDER_ACCOUNT_SELECTION_REDIRECT_PENDING,
SENDER_ACCOUNT_SELECTION_REDIRECT_FAILED,
SENDER_ACCOUNT_SELECTION_CALLBACK_PROCESSING_PENDING,
SENDER_ACCOUNT_SELECTION_CALLBACK_PROCESSING_FAILED,
PAYMENT_REGISTRATION_PENDING,
PAYMENT_REGISTRATION_FAILED,
PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_REQUIRED_CHECK_PENDING,
PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_REQUIRED_CHECK_FAILED,
PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_REDIRECT_PENDING,
PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_CALLBACK_PROCESSING_PENDING,
PAYMENT_CONSENT_AUTHENTICATION_METHOD_SELECTION_CALLBACK_PROCESSING_FAILED,
PAYMENT_CONSENT_REQUIRED_CHECK_PENDING,
PAYMENT_CONSENT_REDIRECT_PENDING,
PAYMENT_CONSENT_REDIRECT_FAILED,
PAYMENT_CONSENT_CALLBACK_PROCESSING_PENDING,
PAYMENT_CONSENT_CALLBACK_PROCESSING_FAILED,
PAYMENT_EXECUTION_PENDING,
PAYMENT_EXECUTION_COMPLETED,
PAYMENT_EXECUTION_FAILED
Example:

"PAYMENT_CONSENT_CALLBACK_PROCESSING_PENDING"

​
failureReasons
enum<string>[]
required

Failure reasons (for status: FAILED only)

Available options:
UNKNOWN_ERROR,
INTERNAL_TECHNICAL_ERROR,
PAYMENT_EXPIRED,
SENDER_CREDENTIALS_INVALID,
REMITTANCE_INFORMATION_INVALID,
SENDER_ACCOUNT_INVALID,
RECIPIENT_ACCOUNT_INVALID,
RECIPIENT_NAME_INVALID,
CURRENCY_INVALID,
AMOUNT_EXCEEDS_AVAILABLE_FUNDS,
AMOUNT_EXCEEDS_DAILY_LIMIT,
AMOUNT_EXCEEDS_MONTHLY_LIMIT,
AMOUNT_EXCEEDS_LIMIT,
PAYMENT_SCHEME_NOT_ALLOWED,
PAYMENT_SCHEME_MODE_INSTANT_NOT_ALLOWED,
PROVIDER_AGREEMENT_MISSING,
SENDER_BLOCKED,
SENDER_RIGHTS_MISSING,
SENDER_ACCOUNT_BLOCKED,
PAYMENT_ABORTED_BY_SENDER,
PAYMENT_ABORTED_BY_PROVIDER,
SENDER_AUTHORIZATION_NOT_GRANTED,
ACCOUNT_INFORMATION_CONSENT_NOT_GRANTED,
PAYMENT_CONSENT_INCOMPLETE,
PAYMENT_CONSENT_NOT_GRANTED,
PROVIDER_SYSTEM_MAINTENANCE,
PROVIDER_TECHNICAL_ERROR,
MTLS_CERTIFICATE_INVALID,
SIGNATURE_CERTIFICATE_INVALID
Example:
["AMOUNT_EXCEEDS_AVAILABLE_FUNDS"]
​
createdAt
string<date-time>
required

Timestamp of status creation

Example:

"2023-10-01T12:00:00Z"