GuidesObject StatesPayment Attempts

Payment Attempt

A payment attempt undergoes different stages until it reaches its final outcome.


Payment Attempt Statuses

Below are the stages of a payment attempt:

1. requires_action

The payment has not yet been completed, and the customer must take further action to finalize the payment. This could involve confirming details or selecting an alternative method of payment.

2. processing

The payment is being processed after the customer has completed all necessary steps. This typically occurs with slower payment methods, such as bank transfers or wire transfers, which require additional time for third-party institutions to verify and complete the transaction.

3. succeeded

The payment has been successfully processed and completed, meaning no further action is needed from the customer.

4. failed

The payment attempt has failed for some reason, such as insufficient funds, transaction issues, or a declined payment method.


Key Points to Remember:

  • requires_action: Action is still needed from the customer.
  • processing: The payment is in progress but not yet complete.
  • succeeded: The payment was successful.
  • failed: The payment attempt did not go through.