Skip to main content

Payment Status

Creedo provides various payment statuses to track transactions effectively. Below is a breakdown of each status and what it signifies:

payment_pending​

  • The payment process has started, but the user has not yet completed it.
  • This status is typically used for transactions where the user is redirected to a payment gateway but has not yet confirmed the payment.

processing​

  • The payment has been initiated and is currently being processed by the payment gateway or financial institution.
  • No action is required at this stage unless the process takes longer than expected.

on_hold​

  • The payment is temporarily placed on hold due to additional verification or fraud checks.
  • This may require manual intervention or a review process before confirmation.

cancelled_by_user​

  • The user manually canceled the payment before completion.
  • No funds were deducted, and the transaction will not be processed further.

different_amount_paid​

  • The user paid an amount that does not match the expected transaction amount.
  • In such cases, you must consider the received_amount field from our callback to determine the exact amount received and take appropriate action.
  • The payment has been successfully completed and confirmed.
  • The funds have been received, and the transaction is finalized.

suspended​

  • The payment has been temporarily suspended due to security concerns, risk factors, or policy violations.
  • Requires investigation before reinstating or rejecting the transaction.

expired​

  • The payment request expired because the user did not complete the transaction within the allowed timeframe.
  • The user may need to retry the payment.

Summary​

✔️ Success Status: paid, different_amount_paid
❌ Failed Status: expired, suspended, cancelled_by_user
⚠️ Rare Case: Banks may sometimes send a false failed callback first, and later send a successful paid callback — this can cause an initially failed order to become successful afterward.