Orders v2 Capture Status Possible Values

[shawnz]

Hi there, we are trying to integrate the orders v2 API into a new application, which is replacing a previous application that used the NVP API.

I had some questions about the order capture process in the new API.

In the docs (https://developer.paypal.com/docs/api/orders/v2/#orders_capture) we see that the possible statuses upon a successful order capture are as follows:

• CREATED.
• SAVED.
• APPROVED.
• VOIDED.
• COMPLETED.

Besides "COMPLETED", It's not clear to me in what situations these statuses might occur. For example, since we are making the orders with INTENT = CAPTURE, is it ever possible to see the statuses such as "CREATED", "SAVED", "APPROVED", etc? Do we need to check this before releasing the product to the user, or is receiving a 200/201 status enough?

Furthermore, in the result returned we have the field purchase_units[].payments[].captures[].status. Is this something we need to check after a capture and what are the possible values here? Is it possible for more than one capture or payment to be returned in the array and if so, how do we know which one to check for the status?

Thanks, Shawn

[not_here]

Hi @shawnz,

I'm checking with our teams on this. Hope to have an answer soon. 

Christina 

Was my post helpful? If so, please give me a kudos!

[shawnz]

Another update.

I have noticed that there is now a credit card on my sandbox account which, when used, actually DOES cause the INSTRUMENT_DECLINED error flow as indicated in the docs. However that behaviour still differs from the behaviour I observed when using a bad credit card in the paypal live environment. Either way, for now we have accounted for both possibilities in the app.

Did you manage to find any more information about this by any chance @not_here ?

Thanks again, Shawn

[rahul-dighe]

It's best if you handle INSTRUMENT_DECLINES - please read about it more at - https://developer.paypal.com/docs/checkout/integration-features/funding-failure/

with regards to possible status of capture they can be found

https://developer.paypal.com/docs/api/payments/v2/#captures-get-response