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 risk@cryptopay.me. 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.

Last updated