Update check payment status
Updates the status of a processed check payment transaction. This endpoint handles the status transition, updates related bills, creates audit events, and triggers notifications.
The transaction must meet all of the following criteria:
- **Status**: Must be in Processing or Processed status.
- **Payment method**: Must be a check payment method.
### Allowed status values
| Value | Status | Description |
|-------|--------|-------------|
| `0` | Cancelled/Voided | Cancels the check transaction. Reverts associated bills to their previous state (Approved or Active), creates "Cancelled" events, and sends a `payout_transaction_voidedcancelled` notification if the notification is enabled. |
| `5` | Paid | Marks the check transaction as paid. Updates associated bills to "Paid" status, creates "Paid" events, and sends a `payout_transaction_paid` notification if the notification is enabled. |
Authentication
requestTokenstring
API Key authentication via header
Path parameters
transId
The Payabli transaction ID for the check payment.
checkPaymentStatus
The new status to apply to the check transaction. To mark a check as Paid, send 5. To mark a check as Cancelled, send 0.
Allowed values:
Response
Success
responseText
Response text for operation: ‘Success’ or ‘Declined’.
responseCode
Code for the response. Learn more in API Response Codes.
pageIdentifier
Auxiliary validation used internally by payment pages and components.
roomId
Describes the room ID. Only in use on Boarding endpoints, returns 0 when not applicable.
isSuccess
Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.
responseData
The response data.