Transactions(both Payments and Payouts) may have following statuses.
Code | Status | Description |
|---|---|---|
1 | started | Asynchronous payment methods(cc, paypal): Started simply means that the transaction and the redirection URL has been created and no action yet been performed by the customer. Synchronous payment methods: In Direct Debit payments, depending on the Direct Debit payment provider, it's a valid initial status where system will change to pending when transactions are sent to the banks by batch within 24 hours. |
2 | pending | Asynchronous payment methods(cc, paypal): The user submitted the payment, but the acquirer has marked the transaction as pending. This usually means that it takes longer than average to complete the transaction. If transaction stays too long in this state, you should consider it not completed. Synchronous payment methods(dd, dd_b2b, kar, kar_b2b, pix, boleto): The order has been accepted, but payment has to be confirmed manually by the merchant, captured over the API(depending on the acquirer), or captured by the automated system if inbound monitoring is enabled. The pending status is treated as a successful payment for rest of the payment methods. The API returns a successful state or redirects to the merchant's success URL. Status is changed to completed either when the customer has paid the money, or merchant manually marks the transaction completed. |
3 | completed | Transaction is fully completed. Money has arrived in the account, or the transaction has been marked paid manually by the merchant. |
4 | error | There has been an error with the transaction. API returns an error state or redirects to the shop’s error URL. |
5 | canceled | Customer or the merchant has canceled the payment. In case the user has canceled the payment, our or the third party system will redirect to the merchant's given error_url for asynchronous payments. |
6 | declined | The acquirer has declined the payment. Payments that require a risk check are marked as declined if the risk check fails. API returns a declined state or redirects to the shop’s error URL. |
7 | refunded | There are partial or full refunds for this transaction. As even partially refunded transactions will have this status, it's suggested to check the refunded amount of the transaction to know if it was a partial or a full refund. |
8 | authorized | The payment has been authorized successfully but not yet executed. This payment should be captured or reversed later. Mostly used in credit cards to put due amount on hold without charging the card. Authorized transactions automatically gets reversed after certain period of time, if not captured. |
9 | registered | A transaction has been registered but payment has not been executed. This transaction should be completed using the payment request, by referencing this registered transaction's transaction_id as original_transaction_id. Mostly used to register credit cards without charging the due amount. |
12 | reversed | Authorization has been reversed (canceled). The transaction is considered canceled. Mostly used in credit cards. |
13 | chargeback | Customer has initiated a chargeback on this transaction. Only used in payment methods supporting chargebacks. |