On This Page

Response Statuses Workflow

This workflow describes the sequence of possible statuses you can receive when processing a payment and refund.

Figure:

Response Statuses Workflow
  1. (Optiona) When the customer is ready to make a purchase, you send a sale API request to
    Cybersource
     and receive one of these possible statuses:
  2. When the customer is ready to make a purchase, you send a sale API request to
    Cybersource
     and receive one of these possible statuses:
    • COMPLETED
      : The request is successful and the sale is complete. No further action is needed.
    • FAILED
      : The request is not successful due to the PPRO supported payment method declining the request. Send a new sale request.
    • INVALID_REQUEST
      : The request is not successful due to invalid information in the request. Send a new sale request.
    • PENDING
      : The request is successful and is currently processing. Redirect the customer to the payment method's URL in the response in order for the customer to complete the payment. Send periodic retrieve a transaction requests until the status updates.
    • SERVER_ERROR
      : The request is not successful due to a system timeout error. Resend the sale request.
    • SUCCEEDED_PENDING_FUNDS
      : The request is successful. PPRO is reviewing the request before releasing the funds. Send periodic retrieve a transaction requests until the status updates.
  3. To verify that the sale is complete, you send a retrieve a transaction API request to
    Cybersource
     and receive one of these possible statuses:
    • COMPLETED
      : The customer has completed the checkout using the redirect URL and the sale is complete. No further action is needed.
    • FAILED
      : The request is not successful due to the PPRO supported payment method declining the request. Send a new request.
    • PENDING
      : The customer has not yet completed checking out using the redirect URL. Continue sending periodic retrieve a transaction requests until the status updates.
    • SERVER_ERROR
      : The request is not successful due to a system timeout error. Resend the request.
    • SUCCEEDED_PENDING_FUNDS
      : The request is successful. PPRO is reviewing the request before releasing the funds. Continue sending periodic retrieve a transaction requests until the status updates.
  4. When the customer returns a purchase, you send a refund API request to
    Cybersource
     and receive one of these possible statuses:
    • FAILED
      : The request is not successful due to the PPRO supported payment method declining the request. Send a new refund request.
    • INVALID_REQUEST
      : The request is not successful due to invalid information in the request. Send a new sale request.
    • PENDING_FUNDS
      : The request is not successful due to either a financial limitation, legal restriction, or operational reason, such as money-holding regulations or anti-money laundering (AML) regulations. Send a new refund request.
    • REFUNDED
      : The request is successful and the refund is complete. No further action is needed.
    • SERVER_ERROR
      : The request is not successful due to a system timeout error. Resend the refund request.