Deferred transactions overview

🔶
Legacy API. This topic describes our original API. If you are integrating with Vitesse, use Vitesse API instead.

Deferred transactions go into a "pool" of outstanding transactions before being processed.

There are three phases in a deferred transaction:

Phase 1 - DTX added to pool

You send us one or more deferred transactions requests (DTX), validated and added to a "pool". To create a deferred transaction, call the Create method on the API.

Phase 2 - Grouping

You can only group DTX with the same sending currency. To group transactions, please call Create Group. This returns a group reference code and the total DTX amount in that group.

In the example above, a request is made to group two USD sourced transactions.

Phase 3 - Release after payment

When the sending account is funded, the DTX are realweased for further processing.

The states associated with DTX are as follows...

When a DTX is in the "PendingGrouping" state we are waiting for you to group it. It will then transition to "PendingPayment" which is when funds are awaited. When funds arrive, the DTX will transition to an immediate transaction.