Transaction statuses
This info page will help you better understand what each order status means, and which next actions are possible for each of them. We will also explain the most common mistakes our customers make, and how you can avoid them while still achieving your desired outcome.
Customer attempts payment
API reference: initialized
The end-customer attempts to pay with their selected payment method. Next possible outcomes: On hold, Authorized, Rejected, Failed
On hold
API reference: on_hold
The payment is put on hold for manual review. This status is only used by Walley. Next possible outcomes: Rejected, Authorized
Authorized
API reference: authorized
The payment has been approved, but the amount has not yet been captured. The money will not be paid out to the merchant until it’s captured. Next possible actions: Partially capture, Capture, Cancel
Partially captured
API reference: partially_captured
Only part of the authorized amount has been captured. There is a remaining authorized amount that can be captured if you want. Next possible actions: Partially refund, Partially capture, Capture, Cancel remaining amount
Captured
API reference: captured
The entire authorized amount has been captured from the customer. Next possible actions: Refund, Partially refund
Cancelled
API reference: authorization_voided
The authorized amount can no longer be captured. You cannot undo this.
Partially refunded
API reference: partially_refunded
The customer has been refunded part of the amount they paid. It usually takes 1–3 business days until the money is back on the customer’s account. Next possible actions: Refund, Partially refund.
Refunded
API reference: refunded
The entire amount paid has been refunded to the customer. It usually takes 1–3 business days until the money is back on the customer’s account.
Rejected
API reference: rejected
The payment was declined, either by the payment provider or manual review.
Failed
API reference: failed
Payment failed. The customer must try again using a different method or check their payment details.
WooCommerce comparison
If you’re using WooCommerce, it’s helpful to understand how Dintero’s statuses map to WooCommerce’s. You’ll also find links to relevant actions.
Dintero status |
WooCommerce status |
|---|---|
|
Customer attempts payment |
Awaiting payment |
|
On hold |
Manual review |
|
Authorized |
Processing |
|
Partially captured |
Completed + How to capture |
|
Captured |
Completed |
|
Cancelled |
Cancelled |
|
Partially refunded |
Completed + How to refund |
|
Refunded |
Refunded |
|
Rejected |
Cancelled |
|
Failed |
Cancelled |
Common mistakes
Refunding an authorized order
An order with status Authorized is not completed. You have only been authorized to capture an amount. If the customer wants to cancel, you must cancel the order — there’s nothing to refund yet. This unfreezes the reservation on the customer’s card (or cancels your invoice authorization).
Partially refunding too early
If you want to remove items before capture, it’s better to adjust the amount before capturing. Edit the order and capture a lower amount instead. This results in a partial capture — meaning the customer is only charged for what you actually capture. Learn how in WooCommerce.