Transaction behavior
How payments work
Once a customer subscribes to your plan, the initial transaction is queued, depending on the trial period you have set for that particular plan. Once the trial period set has elapsed the transaction will be initated.
Payment lifecycle
- Once your customer has subscribed to a plan, the inital transaction is queued.
- Once the trial period has elapsed, the first transaction will transition to READY state.
- As soon as the payment has successfully been collected from the customer in an automated manner from the saved card they have associated to their subscription. That particular transaction will transition from READY to COMPLETE.
- The following transaction set in the parameters you have dictated in your plan details will be QUEUED.
Payment reclaimation
If a customers saved card does not have the necessary funds to pay the subscription on the due date of the plan then a reclaimation process will be initiated. If the first payment fails, the second attempt will be made 2 days after the failure of the first transaction. If the second payment attempt fails a third attempt shall be initiated 3 days after the second attempt failed. Safepay facilitates 3 attempts to reclaim the funds, if the amount is not recieved within these 3 attempts then the subscription will automatically transition from an active state to CANCELED.
Payment Statuses
Payment statuses represent different stages of a financial transaction, showing where it stands within the payment process. These statuses help merchants track and manage payments effectively.
| Status | Definition |
|---|---|
| READY | A transaction in the ready state is prepared for processing but has not yet been initiated. |
| QUEUED | The queued state indicates that the transaction is in line for processing and waiting for its turn. |
| COMPLETE | A complete transaction has successfully traversed the payment process, with funds transferred as intended. |
| RETRY | A retry transaction state occurs when there's a hiccup during processing, and the system attempts to process the transaction again. |
| FAILED | A failed transaction means that the payment process encountered an issue preventing successful completion, requiring attention and possible intervention. |
| UNCOLLECTIBLE | The uncollectible state signifies that the transaction cannot be collected, often due to issues like expired cards or insufficient funds. |
| VOID | A void transaction state implies that the transaction has been nullified before processing, typically upon the customer's or merchant's request. |