On This Page
Response Statuses for Authorizing a Payment Workflow
This workflow shows the statuses that can occur at each stage of the payment process.
Figure:
Authorization Payment Statuses
- You request a create order and receive one of these possible statuses:
- PAYER_ACTION_REQUIRE: The request was successful, and you must redirect the customer to the PayPal checkout URL in order for the customer to approve the payment.
- INVALID_REQUEST: The request was not successful. Send a new request.
- You request a check status for the created order and receive one of these possible statuses:
- COMPLETED: The order was approved by the customer. This status can also occur when the order is successfully used for an authorization or sale.
- INVALID_REQUEST: The request was not successful. Send a new request.
- You request an authorization and receive one of these possible statuses:
- COMPLETED: The authorized funds were successfully captured.
- INVALID_REQUEST: The authorization request was not successful. Send a new authorization request.
- PENDING: The authorization request was successful, and PayPal is reviewing the request. Use the check status request as often as necessary until the status updates.
- If you or the customer decide to cancel the payment, you request an authorization reversal and receive one of these possible statuses:
- REVERSED: The reversal request was successful, and the authorized funds are released from hold.
- INVALID_REQUEST: The reversal request was not successful. Send a new reversal request.
- You request a capture and receive one of these possible statuses:
- COMPLETED: The funds were successfully captured, and the payment is complete.
- DECLINED: The funds were not captured because PayPal declined the request after a review.
- INVALID_REQUEST: The capture request was not successful. Send a new capture request.
- PENDING: The capture request was successful and is being reviewed by PayPal. Use the check status request as often as necessary until the status updates. For more information, see Check Status for a Transaction.
- If the customer returns a purchase, you request a refund and receive one of these possible statuses:
- PENDING: The refund request was successful and is being reviewed by PayPal. Use the check status request as often as necessary until the status updates.
- REFUNDED: The captured funds were successfully refunded to the customer's account. This status can also occur during a customer dispute, such as a chargeback or reversal.
- INVALID_REQUEST: The refund request was not successful. Send a new refund request.