Overview
The Acquired.com API returns a status within the response for every request that you make. The status is a string type and indicates the current status of the request.
For statuses, declined, blocked, tds_error, tds_expired and tds_failed, there is also a reason associated that gives you more specific detail into what has occurred. For more information on reasons, view the reasons guide.
List of statuses
Statuses are broken down into card payment statuses and Pay by Bank statuses.
Card payment statuses
| Status | Description |
|---|---|
success | The request or payment has been successfully processed. |
declined | The payment request was declined by the bank, or the user failed to authenticate the payment. |
blocked | There is a pre-configured rule that stopped the payment request from being processed. |
error | The request was received, but an error has occurred within the platform. |
tds_error | The user has not abandoned the process, but a technical issue has been encountered during the authentication process. |
tds_expired | The session has expired as the cardholder has not completed the authentication process. |
tds_failed | The authentication process has failed. This status could occur due to a number of reasons. |
tds_pending | Awaiting authentication completion. |
Pay by Bank statuses
| Status | Description |
|---|---|
settled | The payment has been received into your Acquired.com settlement account. This status is only applicable for customers that use Acquired-held accounts, where Acquired.com collects the money. |
executed | The payment request has been executed by the bank. If the funds are settled outside of an Acquired.com ledger, the final payment status would stay at executed. |
cancelled | The user did not provide consent for the payment, selecting to reject the payment. |
expired | The payment has expired, i.e been abandoned by the user. The merchant would never actually receive this status, as they are only updated about the final status of the payment. |
error | The payment has failed. This could be because of an internal error or because something is wrong with the Faster Payments network. |
declined | The payment request was declined by the bank, or the user failed to authenticate the payment. |
Payout statuses
| Status | Description |
|---|---|
success | The request or payout has been successfully processed. |
declined | The payout request was declined by the bank. |
error | The request was received, but an error has occurred within the platform. |