July 17, 2024
Showing results for 
Search instead for 
Did you mean: 

What will be the flow of APIs and Webhooks for Chargeback ?

New Contributor III

Hi @all,

As mentioned in previous question, our team is working on a POC on Chargeback. We are pretty much clear on the Conceptual and Theoretical side, but we are still struggling from the API's flow side.

So, the flow that we understood is as follows:

  1. Customer will clear a transaction, can be simulated via /simulate/authorization and then /simulate/clearing.
  2. Using the token from the above APIs, customer can raise a dispute in case of any issue.
  3. So, Customer can use /cases endpoint to create a new dispute case, with amount less than or equal to transaction's amount.
  4. Then, customer can use /cases/{disputeToken}/contents to add supporting documents for their dispute case.
  5. Once, all of the documents are uploaded and reviewed, customer will use /cases/{disputeToken}/transitions to move the transition state to CHARGEBACK_INITIATED.

From here on, we are stuck on the issue, where we aren't sure to wait for network's progress or to create a new Network's transition state ?

And how will the flow of APIs will go on from here.


Thanks and Regards,

Arvind Singh Rawat


Marqeta Staff
Marqeta Staff

Hi Arvind!

Apologies for the delay. You will be waiting for the network  to run through their disputes/chargeback process. As progress is made, you will be sent webhooks on the status of the submission. Take a look at this and let me know if it helps answer some of your questions. https://www.marqeta.com/docs/developer-guides/about-disputes#_the_dispute_lifecycle.   The next link talks about who owns the transitions (Note: this is from the viewpoint that  Marqeta acting as the facilitator of the dispute) https://www.marqeta.com/docs/developer-guides/about-disputes#_network_dispute_states.

Hope this helps!