Skip to main content
Version: 1.0.0

Payment method statuses

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

processingThe payment method record has been created in Gr4vy and is now being processed with your payment services.
processing_failedThe payment method could not be processed with any payment service due to technical issues.
buyer_approval_pendingThe payment method 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 payment method.
buyer_approval_declinedThe payment method was created and needed approval from the buyer, but the buyer declined the approval.
buyer_approval_timedoutThe payment method was created and needed approval from the buyer, but the buyer failed to approve the payment method before it timed out. Most approvals time out after 1 hour but this might change in the future.
storedThe payment method was successfully stored with all payment services and the id can now be used to create new transactions.
usedThe payment method was used in a one-off transaction and it was not vaulted with any payment service.

State diagram

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


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