Version: Beta

Transaction statuses

A transaction's status value can be one of the following depending on the state within Gr4vy and the status within the used payment service.

statusDescription
processingThe transaction record has been created in Gr4vy and is now being processed with your payment services.
processing_failedThe transaction could not be processed with any payment service due to technical issues.
capture_succeededThe transaction has been successfully captured.
capture_pendingThe transaction has successfully been submitted for capture with a payment service and is now pending with them.
capture_declinedThe transaction was submitted for capture but has been declined by all payment services.
capture_failedThe transaction could not be captured with any payment service due to technical issues.
authorization_succeededThe transaction has been successfully authorized.
authorization_pendingThe transaction has successfully been submitted for authorization with a payment service and is now pending with them.
authorization_declinedThe transaction was submitted for authorization but has been declined by all payment services.
authorization_failedThe transaction could not be authorized with any payment service due to technical issues.
authorization_expiredThe transaction was successfully authorized but has since expired. Most authorizations have an expiration length. Check your payment service for more details.
authorization_voidedThe transaction was successfully authorized but has since been canceled before it was captured.
refund_succeededThe transaction was successfully captured but has since been refunded.
refund_pendingThe transaction has successfully been submitted for refund with a payment service and is now pending with them.
refund_declinedThe transaction was submitted for refund but has been declined by all payment services.
refund_failedThe transaction could not be refunded with any payment service due to technical issues.
buyer_approval_succeededThe transaction was successfully approved by the buyer.
buyer_approval_pendingThe transaction was created but needs approval from the buyer. This is mainly used in alternative payment methods like PayPal where the user needs to be redirected to PayPal to complete the transaction.
buyer_approval_declinedThe transaction was created and needed approval from the buyer, but the buyer declined the approval.
buyer_approval_failedThe transaction was created and needed approval from the buyer, but the buyer approval failed.
buyer_approval_timedoutThe transaction was created and needed approval from the buyer, but the buyer failed to approve the transaction before it timed out. Most approvals time out after 1 hour but this might change in the future.

State diagram#

The following state diagram serves as an overview of all the different status values and how they relate to each other.

note

The processing_failed status has been left out of this diagram as too many statuses can lead to this outcome.