Payment Status Reference

Overview

Each payment processed through Inflow includes a status label to help you understand its progress and outcome. These statuses reflect key points in the lifecycle of a transaction—from initiation to settlement.

Status Labels Reference Table

Status Label	Description	Payment Status Values
INCOMPLETE	The payment was initiated but not completed by the customer.	`INITIATION`, `CHECKOUT_PENDING`
AUTHORIZED	Funds have been approved but are not yet settled to your account.	`CHECKOUT_SUCCESS`, `PAYMENT_RECEIVED`
SETTLED	Payment has been successfully received and added to your balance.	`PAYMENT_SUCCESS`
FAILED	The payment failed (e.g., due to bank error, invalid account, or timeout).	`PAYMENT_FAILED`
CANCELED	The user canceled the payment before it could be completed.	`CHECKOUT_CANCELED`, `CANCELED`
REFUNDED	The payment has been fully refunded to the customer.	`FULLY_REFUNDED`
PARTIAL_REFUNDED	Part of the payment has been refunded to the customer.	`PARTIAL_REFUNDED`
REFUND_PENDING	A refund is currently being processed.	`REFUND_PENDING`
EXPIRED	The payment link or session has expired.	(Mapped from expired payments)

Detailed Payment Status Values

Payment Status Enum Values

Payment Status	Label Mapping	Description
`INITIATION`	INCOMPLETE	Payment was created but customer hasn't started checkout
`CHECKOUT_PENDING`	INCOMPLETE	Customer is preparing the payment in checkout
`CHECKOUT_SUCCESS`	AUTHORIZED	Customer has successfully completed checkout, payment authorized
`CHECKOUT_CANCELED`	CANCELED	Customer canceled during checkout
`CANCELED`	CANCELED	Payment was canceled
`PAYMENT_RECEIVED`	AUTHORIZED	Fiat funds received by the onramp provider (authorized but not settled)
`PAYMENT_SUCCESS`	SETTLED	User wallet received the crypto sent by the onramp provider (fully settled)
`PAYMENT_FAILED`	FAILED	Payment processing failed
`PARTIAL_REFUNDED`	PARTIAL_REFUNDED	Part of the payment has been refunded
`FULLY_REFUNDED`	FULLY_REFUNDED	The entire payment has been refunded
`REFUND_PENDING`	REFUND_PENDING	A refund is being processed
`REFUND_FAILED`	(No label)	Refund processing failed

Status Use Cases

INCOMPLETE

May occur if the customer leaves the checkout page before completing payment
Payment is initiated but not finalized
Status values: INITIATION, CHECKOUT_PENDING

AUTHORIZED

Funds have been approved and received by the payment provider
Useful for delayed settlement methods such as cards or bank transfers
Payment is confirmed but not yet settled to merchant account
Status values: CHECKOUT_SUCCESS, PAYMENT_RECEIVED

SETTLED

The transaction has been finalized and funds are available
Payment is complete and settled to merchant account
Status value: PAYMENT_SUCCESS

FAILED

The payment failed due to various reasons:
- Bank error
- Invalid account details
- Insufficient funds
- Timeout
- Provider error
Review error logs or customer contact if recurring
Status value: PAYMENT_FAILED

CANCELED

The user canceled the payment before it could be completed
Customer-initiated cancellation
Status values: CHECKOUT_CANCELED, CANCELED

REFUNDED

Payment has been fully refunded to the customer
Funds have been returned
Status value: FULLY_REFUNDED

PARTIAL_REFUNDED

Part of the payment amount has been refunded
Remaining amount may still be available
Status value: PARTIAL_REFUNDED

REFUND_PENDING

A refund is currently being processed
Refund request has been submitted but not yet completed
Status value: REFUND_PENDING

Notes

Status Labels are user-friendly labels used for display and filtering
Payment Status Values are the actual database values stored in the status field
Multiple payment status values can map to the same label (e.g., both CHECKOUT_SUCCESS and PAYMENT_RECEIVED map to AUTHORIZED)
When calculating volumes or metrics, typically use statuses: CHECKOUT_SUCCESS, PAYMENT_RECEIVED, PAYMENT_SUCCESS (authorized and settled)
Exclude refunded, failed, and canceled payments when calculating successful transaction volumes