Transactions

A transaction is a payment attempt made through a payment channel on Asyncpay. Every transaction is linked to a payment channel and represents an attempt by Asyncpay to charge via a payment channel.

Whenever a payment request is relayed to a payment channel, the last pending transaction on that payment request is voided and a new transaction is created to represent the new relay attempt. Asyncpay tracks each transaction and uses them to show a comprehensive timeline of your users on each payment request on your dashboard.

Viewing a payment request and the transaction timeline.

Transactions have an expiry period of 24 hours. If a transaction is not successfully resolved within 24 hours, it expires and automatically expires the payment request if it has one tied to it as well. There are no endpoints to directly interact with transactions on the Asyncpay APIs but it is necessary to understand how they work.

Transaction Statuses

A transaction can have different statuses that signifies its point in its lifecycle.

• pending- This means the transaction has been created and it is pending a successful payment attempt. If the transaction is tied to a payment request and the payment request is relayed to a new payment channel, the last transaction attached to the payment request will be voided and a new pending transaction would be created.

• successful- This means the payment request is available to be relayed to a payment channel. This process initiates all the successful processes that should occur such as sending out payment request webhooks.

• voided - This means the payment request this transaction was attached to was relayed to a new payment channel and this transaction was voided or invalidated.

• expired - A payment request is expired if it has been in the pending for 24 hours and no successful payment attempt was made.

• failed - This occurs if the transaction fails and the payment provided attached to the transaction no longer accepts payment attempts for the same transaction.