Skip to main content

Understand order and payment statuses

Read order and payment states together to decide when to request action, fulfill, or investigate.

Y
Written by Yaw Boakye

An order records what your customer is buying. Its payment records what has happened to the money. Reading both tells you what to do next.

Do not treat an invoice, a used Buy link, a payment prompt, or a customer’s screenshot as a substitute for the order’s current payment information.

Open the order first

Go to Orders, find the order, and open its details. Confirm the business account, customer, order reference, amount, and currency.

Read the current order state alongside the payment details and any next action shown. When investigating a recent payment, refresh the record before deciding what happened.

What the order states mean

Preparing

Meaning: The order is being prepared or has not yet progressed into the payment flow. Finalization is a separate consideration.

Your next step: Review its details and whether an invoice is available. Finalize when ready.

Requires payment

Meaning: The order still needs successful payment. A payment attempt may already be underway.

Your next step: Read the payment state and next action before asking the customer to do anything else.

Paid

Meaning: Payment has been recorded as paid for the order.

Your next step: Review the payment record, then fulfill the purchase according to your workflow.

Completed

Meaning: The order has been marked completed after fulfillment.

Your next step: Use its existing records for follow-up; do not recreate the purchase.

Canceled

Meaning: The order has been canceled and cannot restart payment.

Your next step: Check payment and refund records before deciding whether a new order is appropriate.

Expired

Meaning: The order’s buying opportunity has expired.

Your next step: Review any unresolved payment before preparing a new order.

Preparing does not, by itself, tell you whether the order has a hosted invoice. A draft lacks one; finalization makes one available. Use the actual invoice state rather than guessing from a single label.

When payment requires action

A payment may still require something from the customer or provider.

Depending on the stage, the customer may need to start payment, enter a confirmation code in the payment flow, or approve the payment through their provider.

Entering a code is not always the last step. The payment can still be waiting for provider authorization or confirmation afterward.

Ask the customer to follow the instructions on the payment page. Do not ask them to send you their wallet PIN, password, or one-time code in a chat. Those details belong only in the legitimate payment or provider flow.

If the payment is already waiting on an external provider, do not start a second attempt simply to make the screen change. First establish the result of the existing attempt.

When payment fails

A failed attempt does not necessarily cancel the order. The order may still require payment and offer a supported retry or a different payment method.

Before asking the customer to retry, check whether the attempt is definitively failed or still unresolved. If they report that money was deducted, investigate that report before requesting another payment.

Read the error and address the issue it identifies. If the message is unclear, contact us before another attempt.

Paid and completed mean different things

Paid answers, “Has payment been recorded?” Completed answers, “Has this order been marked fulfilled?”

For example, a paid order for a delivery still needs the goods to be delivered. A paid consultation still needs the agreed service to be provided.

Mark the order completed after delivering the goods or service. Payment and fulfillment remain separate steps.

Payments recorded outside Inttegro

An order can have a payment recorded as paid outside Inttegro. That is different from Inttegro processing a payment through a provider.

If you use an offline-payment action, it records a fact your team is responsible for verifying. It does not collect money from the customer or create a payout from funds that never passed through Inttegro.

Only record an external payment after checking that it was actually received. Do not use the action to bypass a pending online payment, match an unverified screenshot, or remove a warning.

For an order marked paid, inspect how payment was recorded if you are trying to reconcile the money.

Refunds are separate from the original order

A paid or completed order remains the record of the original purchase. A refund has its own amount and status.

A pending refund means a return is underway; it does not change the fact that the original payment succeeded. The refund record shows the amount returned while the order preserves the original purchase.

Open the related refund to see what was requested and what has actually completed. If there are several partial refunds, review them together.

Common situations

The Buy link says Used, but the order is unpaid. A single-use link is consumed when it creates an order. Open that order’s invoice and payment details; link use is not payment confirmation.

The customer entered a confirmation code. Check whether the provider still needs authorization or whether the payment has reached a final result.

The customer has a screenshot saying payment was sent. Match the reference, amount, and time to the actual order. If the records disagree, investigate before requesting a retry or fulfilling solely on that evidence.

The order is completed but the customer asks for money back. Review refund eligibility and use the refund workflow. Completion does not record a refund.

If the state is unclear, contact us with the order reference and what you expected to happen next. For the technical state model, see Order lifecycle in Studio.

Related guides

Did this answer your question?