Payment statuses

Each Channel Payment is associated with its parent Channel.

Channel Payments have several status options and we send callbacks on every status change.

status	status_context	Description
pending	null	A channel payment has been created. It means that a customer has just broadcast their transaction on the network
completed	null	The transaction has been confirmed on the network and the payment amount has been added to your account balance
on_hold	illicit_resource	The received cryptocurrency transaction has been evaluated as High-Risk, therefore the payment transaction has been put on hold
on_hold	channel_disabled	A parent Channel has been disabled, therefore the payment transaction has been put on hold
refunded	null	The funds have been returned to the sender
cancelled	null	The transaction hasn't been confirmed on the network within 14 days

You can see that there are 3 other statuses besides pending and completed.

For example, the cancelled status is assigned to a payment if the transaction has not been confirmed on the blockchain within 14 days since the customer sent it to the channel address. This may occur when the user has made a double spend of funds.

The on_hold status with the illicit_resource context is assigned to a payment when the payment has received a high risk level. In case you get a High-Risk payment it is required you contact us at [email protected]. Our Transaction Monitoring team will review this transaction shortly to make a decision on whether we will be able to reduce the risk level and process this payment and add the funds to your account balance, or we will have to send the funds back to the sender. Please refer to the Risks section to get more details on what High-Risk transactions are and why we take it very seriously. Once the transaction has been sent back, the payment will change its status to refunded. If the payment has not been returned to the sender but has been credited to the merchant balance, the payment changes its status to completed.

Channel payment statuses diagram

All the steps from creation of the channel to the moment the payment is credited to the balance can also be viewed here.