# PayoutStatus

> A schema in the Payouts API reference. Source: https://hub.ozow.com/api-reference/payouts-api/schemas/payout-status/

## Fields

- `status` (integer, int32, required, min 0, one of 1, 2, 3, 4, 5, 6, 7, 90, 99) - The payout status. 1: Payout Received. The payout has been received. 2: Verification. The payout is being verified. 3: Payout Submitted For Processing. The payout is being processed. 4: Payout Processing Error. There was an error with the payout. 5: Payout Completed. The payout has been completed. 6: Payout Pending Investigation. The payout is being investigated. 7: Payout Pending Cancellation. Cancellation has been requested and is not yet settled. 90: Payout Returned. The payout could not be paid into the recipient account. 99: Payout Cancelled. The payout was cancelled.
- `subStatus` (integer, required, min 0) - The payout sub status. Possible values are: 100: Payout_Unclassified – No sub status. 101: Payout_ValidationFailed – Request validation failed and error description will be in the ErrorMessage field. 201: Verification_Pending – Awaiting webook verification. 202: Verification_Failed – The verification webhook returned a failed. 203: Verification_Success – Successful payout verification via webhook. 204: Verification_Error – Unable to reach the verification webhook. 205: Verification_AccountNumberDecryptionFailed – Decryption of the account number failed using the key received via webhook. 301: SubmittedForProcessing_PayoutAddedToBatch – The payout has been added to the payout batch. 302: SubmittedForProcessing_PayoutSubmittedToBank – The payout batch has been processed and submitted to the bank. 303: SubmittedForProcessing_PayoutSubmittedToPpi – Payout submitted for processing. 401: PayoutProcessingError_PayoutRejected – The payout has been rejected by the bank. 402: PayoutProcessingError_PayoutCancelled – The payout has been cancelled. 403: PayoutProcessingError_Insufficient_Balance – Insufficient balance. 404: PayoutProcessingError_PayoutInternalError. 405: PayoutProcessingError_InvalidAccountNumber – The payout has an invalid account number. 601: PayoutPendingInvestigation_AmountMismatch – The payout failed due to mismatch in amounts. 9001: PayoutReturned_Unpaid – Rejected by destination bank. 9901: Cancellation_AddedToBatch – Cancellation request added to batch for processing. 9902: Cancellation_SubmittedToBank – Cancellation request has been submitted to the bank. 9903: Cancellation_RejectedByBank – Cancellation request has been rejected by the bank. 9904 - Cancellation_AccountNumberValidationFailed – CDV account number validation failed.
- `errorMessage` (string, max length 250) - Error message generated when validating the request.
