Orders v2 Capture Status Possible Values

shawnz
Contributor
Contributor

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

Login to Me Too
12 REPLIES 12

not_here
Moderator
Moderator

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!

Login to Me Too

shawnz
Contributor
Contributor

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

Login to Me Too

rahul-dighe
PayPal Employee
PayPal Employee

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

Senior Product Manager - PayPal Checkout API Product
Login to Me Too

Haven't Found your Answer?

It happens. Hit the "Login to Ask the community" button to create a question for the PayPal community.