Payment Status issues

Hi, Team
I have some payment status questions to ask

  1. What does the Pending payment status mean? It says “Transaction detected on the blockchain but not yet validated by the network”, does it mean Transaction have broadcast in to the network, but still not included into the block.

  2. When use webhook, There are some difference about the payment status

    • charge:failed , What circumstances will notify this status?
    • charge:pending, is it the same as the payment status above?

Hi @Jeffer! Thank you for taking an interest in trying out Coinbase APIs. For the details regarding your inquiry, we will check on this for you with our team to see how we can best assist. We’ll get back to you once we have more information. Keep in touch!

1 Like

Hello @Jeffer! Welcome to the forum! We appreciate you taking your time to lay out your questions clearly. To answer your queries, we’ve itemized your concerns as well.

(1) When invoices are viewed and agreed on by your customers, it automatically creates a charge corresponding to the agreed upon amount alongside other details included in the invoice. With this said, once payments are made by the customer to the associated address generated specifically for the charge generated, it is broadcasted publicly and needs to be validated similar to other transactions done on the respective blockchain. You are correct in your understanding that pending charges are already published but still not validated and added onto a valid block within the said chain.

(2) A charge:pending status is applied to the aforementioned scenario while a charge:failed status is applied to those rejected by the network, either through cancelled payments or some other type of error encountered by the original transaction.

We hope we were able to address your concern. Feel free to reply in this thread if you have further questions.

1 Like

Thanks for answering my question,

one more question, what payment status will charge:delayed be included.

Hello @Jeffer ! We’re glad that we are able to help.

With your added query, we wish to confirm that charge:delayed is actually under unresolved payment status based on this documentation link. Please note that a charge will be automatically categorized as delayed if payment was made after 60 minutes had passed after creating the charge. Additionally, you may also refer to this link for more details about all possible payment statuses.

We hope we are again able to address your concern. You are always welcome to reply to this thread shall you need further clarifications.


Hi, @ereeca15

I just found out that when an order does not complete the process because of under paid reasons, while the webhook receives a charge:failed message. so if this is the case, how do I determine if the order is canceled or not completed for other reasons?

Hi there @Jeffer! Welcome again to the forum! For the details regarding your concern, we will check on this for you with our team to see how we can best assist. We’ll get back to you once we have more information. Keep in touch!

1 Like

Hello @Jeffer! We appreciate your patience while we check this with our team. Regarding your query, as of the moment, there’s no way to determine the specific reason when an order is cancelled or not completed. However, this is an interesting feedback so we recommend you to post this in the Feedback Section of the Developer Forum as most new features and improvements to Coinbase come directly from feedback like yours, so it’s very valuable to us. Thank you and have a great day!

1 Like